Python与VS Code版本异常：终端显示旧版本，PyGame导入失败

一、终端与VS Code版本不一致的原因 #

• 系统PATH优先级差异：终端执行python时，会按照系统PATH环境变量的顺序查找可执行文件，若Python 3.9.12的路径排在3.11之前，就会优先调用旧版本。而VS Code是直接指定了3.11的解释器路径，因此显示版本不同。
• 虚拟环境关联：若终端当前处于基于Python 3.9.12创建的虚拟环境中，python命令会指向虚拟环境内的版本，与VS Code使用的全局解释器无关。
• Python Launcher默认设置（Windows）：Windows自带的Python Launcher（py.exe）可能默认关联了3.9.12，直接执行python会触发该默认配置。

二、定位并卸载Python 3.9.12的方法 #

1. 定位安装路径 #

执行对应命令获取python可执行文件的完整路径：

# Windows PowerShell
Get-Command python | Select-Object -ExpandProperty Source

# Windows CMD
where python

# macOS/Linux
which python

若为虚拟环境版本，执行pip --version，输出内容会包含该pip对应的Python安装路径。

2. 卸载操作 #

• 系统自带卸载程序：
  • Windows：打开「设置」→「应用」→「应用和功能」，搜索“Python 3.9”，找到对应版本后点击卸载。
  • macOS：官方pkg安装的版本，打开「应用程序」文件夹，运行Python 3.9文件夹内的Uninstall Python.pkg；Homebrew安装的执行brew uninstall python@3.9。
  • Linux（Debian/Ubuntu）：执行sudo apt remove python3.9；RHEL/CentOS：sudo yum remove python39。
• 手动删除（无卸载程序时）：
  1. 按第一步获取的路径找到Python 3.9的安装文件夹，直接删除。
  2. 打开系统环境变量设置，移除该Python版本对应的PATH条目。
  3. Windows用户需清理注册表：打开regedit，导航至HKEY_LOCAL_MACHINE\SOFTWARE\Python\PythonCore\3.9和HKEY_CURRENT_USER\SOFTWARE\Python\PythonCore\3.9，删除对应项（操作前建议备份注册表）。

3. 统一版本验证 #

卸载旧版本后重启终端，执行python --version确认是否切换至3.11。若仍有问题，调整系统PATH，将Python 3.11的路径移至最顶端。

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