如何修改VS Code中的Python版本？本地切换后终端仍显示旧版本

1. 重启VS Code终端 #

VS Code终端会缓存启动时的环境变量，修改系统路径后，已打开的终端不会自动同步更新。直接关闭当前终端面板，重新打开新终端，再执行python --version验证。

2. 确认Python解释器配置生效 #

• 按下Ctrl+Shift+P（Windows/Linux）或Cmd+Shift+P（Mac）打开命令面板，输入Python: Select Interpreter，选中你安装的Python 3.8版本。
• 打开.vscode/settings.json文件，检查配置项：
  新版本VS Code看python.defaultInterpreterPath，旧版本看python.pythonPath，确保路径指向Python 3.8的可执行文件，示例：

  {
    "python.defaultInterpreterPath": "C:/Python38/python.exe"
  }
  

3. 检查是否激活了旧虚拟环境 #

如果之前在VS Code里用过基于Python 3.11的虚拟环境，终端可能自动激活了它。执行deactivate退出虚拟环境，再查看版本；或者直接删除旧虚拟环境，重新基于Python 3.8创建新环境。

4. 完全重启VS Code #

有时候VS Code后台进程会缓存旧环境变量，关闭窗口后在任务管理器里结束所有Code.exe进程，再重新打开软件，让它重新加载系统路径。

5. 检查终端shell的路径缓存 #

• PowerShell：执行$env:Path查看当前路径列表，确认Python 3.8的路径在最前端，无Python 3.11路径残留。临时修复可执行$env:Path = "C:\Python38;$env:Path"，永久生效需修改PowerShell配置文件。
• Git Bash：直接重启终端即可刷新路径缓存。

6. 验证系统环境变量设置 #

右键「此电脑」→「属性」→「高级系统设置」→「环境变量」，在系统变量的Path中，确认Python 3.8的安装路径（如C:\Python38和C:\Python38\Scripts）排在最顶部，且已彻底移除Python 3.11相关路径。修改后点击确定，再重启VS Code。

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