pip 提示 pygame 已安装，编辑器仍报 ModuleNotFoundError：核对 Python 路径

终端安装 pygame 时显示 Requirement already satisfied，编辑器运行脚本却报 ModuleNotFoundError: No module named 'pygame'。如果机器安装了多个 Python，先确认安装包和运行脚本使用的是同一个解释器。

在 macOS 上，命令行工具提供的 Python、单独安装的 Python 和编辑器选定的解释器可能共存。日志里的 Library/Python/3.9/... 只说明包在那套环境中被找到，不能说明另一个 Python 3.12 或虚拟环境也能导入它。

从报错的运行入口取得解释器路径

在编辑器实际运行的脚本中暂时加入以下诊断内容。不要只在另一个终端里运行它：

import sys
print(sys.executable)
print(sys.version)

sys.executable 通常给出当前 Python 可执行文件的绝对路径。记录这个路径，再核对编辑器的构建系统、项目解释器或运行配置是否指向预期环境。嵌入式等特殊环境可能没有可用路径，需按该工具的运行配置进一步查证。

安装输出也要同时查看。Requirement already satisfied 后的目录与 Python 版本是线索；Defaulting to user installation 表示选择了用户级安装位置，不表示所有 Python 共用这份安装。

不要仅凭 python3、pip3 的名称判断它们属于同一环境。命令搜索路径可能先找到另一份安装，激活虚拟环境也不一定改变编辑器已经保存的解释器配置。

选择目标环境，再让 pip 跟随它

如果编辑器选错了 Python，优先将运行配置改为项目本来使用的环境。如果编辑器路径正确，包却装在别处，就用目标解释器调用 pip。

下面是 macOS 路径示例，需替换成刚取得的实际路径：

"/path/to/project/.venv/bin/python" -m pip --version
"/path/to/project/.venv/bin/python" -m pip show pygame
"/path/to/project/.venv/bin/python" -m pip install pygame

前两条用来确认 pip 归属及目标环境是否已安装包；最后一条才会改变该环境的依赖，应遵守项目版本要求。项目有依赖清单或锁定方式时，按项目声明安装，不要为了消除一次导入错误无条件升级全部依赖。

-m pip 让指定的 Python 运行自己的 pip 模块，路径中的空格需要保留引号。不要在 Python 的 >>> 提示符里输入终端安装命令。

目标解释器报 No module named pip 是另一项问题。先核对该解释器是否完整、是否由系统或环境工具管理，按其支持的方法补齐安装能力；不要因此把包又装回另一个全局 Python。系统管理环境出现 externally-managed-environment 时，通常应使用合适的项目虚拟环境，并同步编辑器配置。

两边已一致却仍导入失败

如果安装位置与运行解释器已经核对一致，再检查报错完整内容。只有找不到 pygame 顶层模块时，才继续沿环境搜索路径排查；报 ImportError、动态库加载失败或其他依赖模块缺失，处理方式不同。

也不要为了切换版本先删除所有 Python 安装。先保存编辑器原配置，调整项目运行路径；需要恢复时改回该配置即可。更换解释器可能影响项目其他依赖，应一起检查。

验证时仍从原来的编辑器入口运行脚本。它应显示预期解释器路径并成功导入 pygame，随后继续完成应用需要的初始化。终端导入成功只能验证终端环境，编辑器中的原错误恢复才是这次修复的目标。