VS Code中MinGW64与Python 3.12.2冲突致Pygame运行异常

MinGW64的bin目录自带了Python 3.11.8的可执行文件，尽管你的Python 3.12.2路径在环境变量PATH中排在前面，但系统实际执行时优先调用了MinGW的Python版本——这个版本没有安装Pygame，所以运行程序时会提示no module found pygame。

1. 强制指定Python版本执行 #

运行Pygame程序时，不要直接用python命令，而是指定你安装的Python 3.12.2的完整路径，比如：

C:\Users\你的用户名\AppData\Local\Programs\Python\Python312\python.exe 你的游戏脚本.py

或者如果Python 3.12的可执行文件被命名为python3.exe，直接用：

python3.exe 你的游戏脚本.py

2. 修复环境变量优先级 #

• 打开系统环境变量设置，找到PATH变量
• 确认Python 3.12.2的Scripts和python.exe所在路径确实在MinGW64的bin路径之前
• 修改后，关闭所有已打开的CMD窗口，重新打开再执行python --version，确认显示3.12.2

3. 移除MinGW自带的Python文件 #

如果暂时不需要MinGW里的Python，可以直接删除MinGW64bin目录下的python.exe、python3.exe、python3.11.exe这类文件，避免冲突。

4. 使用虚拟环境隔离（推荐） #

为你的Pygame项目创建独立的虚拟环境，彻底避免全局Python版本冲突：

1. 创建虚拟环境：

python -m venv pygame_env

2. 激活虚拟环境：

pygame_env\Scripts\activate.bat

3. 在激活的环境里重新安装Pygame：

pip install pygame

之后每次运行项目前先激活虚拟环境，就不会受其他Python版本影响。

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