VS Code启动Python项目报错ModuleNotFoundError: No module named 'pygame'怎么办

1. 验证当前项目使用的Python解释器 #

• 打开VS Code命令面板（快捷键Ctrl+Shift+P/Cmd+Shift+P），输入Python: Select Interpreter
• 记录当前选中的解释器路径
• 打开终端，输入以下命令确认该解释器是否安装了pygame：

# 把<解释器路径>替换成你刚才查到的路径，比如C:\Python39\python.exe或者/usr/bin/python3.10
<解释器路径> -m pip show pygame

• 如果返回无匹配包，直接用该解释器安装pygame即可：

<解释器路径> -m pip install pygame

2. 核查项目虚拟环境配置 #

如果合并仓库后新增了虚拟环境相关配置（比如.venv文件夹、requirements.txt、pyproject.toml或者VS Code的.vscode/settings.json配置），按照以下步骤排查：

• 检查.vscode/settings.json中是否有python.defaultInterpreterPath配置项，确认路径指向的环境是否已安装pygame
• 如果项目使用虚拟环境，先激活虚拟环境后再安装依赖：

Windows（PowerShell）：.venv\Scripts\Activate.ps1
macOS/Linux：source .venv/bin/activate
激活后执行pip install pygame即可

3. 核查运行配置 #

• 打开VS Code的运行和调试面板，检查对应的launch配置中python字段的解释器路径是否和你安装pygame的环境一致
• 删掉之前的运行缓存，重启VS Code后重新运行项目

内容的提问来源于stack exchange，提问作者Fullsailer