You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

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

我的VS Code界面

问题根因

这个报错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

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.09.03 04:24:24