Mac环境下VS Code中Pygame安装失败的解决方案咨询

第一步：选中对应虚拟环境的Python解释器 #

• 打开你的Python项目文件夹，看VS Code左下角状态栏，那里显示着当前使用的Python解释器，直接点击它
• 在弹出的列表里，选你之前创建的venv环境下的Python，路径一般是./venv/bin/python3

第二步：在虚拟环境内安装Pygame #

• 打开VS Code的终端面板，先确认终端开头显示了(venv)，这说明虚拟环境已经激活
  • 如果没显示，手动执行激活命令：source venv/bin/activate
• 激活后直接执行安装命令：pip install pygame
  • 想装最新版可以加--upgrade：pip install --upgrade pygame

第三步：验证安装效果 #

• 新建测试文件，输入以下代码：

import pygame
pygame.init()
print(pygame.version.ver)

• 运行文件，能打印出版本号就说明安装成功

常见问题排查 #

• 要是还是报ModuleNotFoundError，先在终端输pip --version，看输出路径是不是venv/bin/pip，不是的话说明没激活对虚拟环境
• 确认创建venv的命令是python3 -m venv venv，Mac上别用python命令，大概率指向系统自带的旧版本Python
• 如果之前误把Pygame装到全局环境了，先执行pip3 uninstall pygame卸载，再重新在venv里安装

是否需要换Wing等开发工具？ #

完全没必要。VS Code对Python的支持足够完善，你遇到的只是虚拟环境和解释器不匹配的问题，换工具解决不了环境配置的核心逻辑，反而要重新适应新工具的操作，把当前环境配置对就行。

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