使用pip安装pygame后仍报ModuleNotFoundError如何解决

问题根因
这个报错10次有9次都是pip安装pygame的目标Python环境,和你VS Code运行代码时用的Python解释器不是同一个,反复全局卸载重装没用,按下面步骤操作就行。
修复步骤(解决ModuleNotFoundError)
- 先确认当前运行环境:在VS Code里按
Ctrl+Shift+P调出命令面板,搜索Python: Select Interpreter,查看当前选中的Python解释器完整路径,记下来。常见路径分两种:全局安装的Python类似C:\Users\你的用户名\AppData\Local\Programs\Python\Python311\python.exe,虚拟环境路径会在项目目录下的venv/Scripts/python.exe位置。 - 强制给当前解释器安装pygame:打开VS Code内置终端,不要直接敲
pip install pygame,执行命令:你刚才记下的完整python路径 -m pip install pygame。举个例子,如果你的解释器是上面说的Python311路径,命令就是C:\Users\XXX\AppData\Local\Programs\Python\Python311\python.exe -m pip install pygame,这个操作会直接把pygame装到你跑代码用的环境里,不会错装到其他Python版本上。 - 验证安装结果:在终端执行
你记下的python路径 -c "import pygame; print(pygame.version.ver)",如果能正常输出pygame版本号,再运行代码就不会报模块找不到的错误。 - 如果你用conda/venv虚拟环境,要么先在终端执行激活命令切到对应环境再装包,要么直接用上面指定解释器全路径的方式安装,全局pip装的包虚拟环境默认无法读取。
pip版本检查警告处理
WARNING: There was an error checking the latest version of pip这个警告不影响包安装,本质是网络问题导致pip无法连接官方服务器检查更新,嫌碍眼就先换国内PyPI源,执行pip config set global.index-url https://pypi.tuna.tsinghua.edu.cn/simple,之后再执行你的python路径 -m pip install --upgrade pip升级pip即可消除警告。
避坑提示
- 不要混装多个Python版本(比如同时装3.9/3.10/3.11)却不手动选择解释器,pip默认会把包装到系统环境变量里优先级最高的Python版本上,和VS Code自动选中的版本往往不一致。
- 尽量不要用微软商店版本的Python,该版本权限策略特殊,频繁出现包装了读不到的问题,建议从Python官方渠道下载正式安装包,安装时勾选
Add Python to PATH选项。
内容的提问来源于stack exchange,提问作者user19093440
相关产品推荐
相关产品推荐

