VSCode安装Python后无法运行，报“Python was not found”错误求助

1. 确认Python安装路径并添加到系统环境变量 #

• 找到你实际安装Python的目录（比如默认路径为C:\Users\<你的用户名>\AppData\Local\Programs\Python\PythonXX，XX对应具体版本号）
• 打开系统环境变量设置：右键「此电脑」→ 属性 → 高级系统设置 → 环境变量
• 在系统变量的Path条目里，添加Python的安装根目录和Scripts子目录（例如C:\Users\XXX\AppData\Local\Programs\Python\Python311和C:\Users\XXX\AppData\Local\Programs\Python\Python311\Scripts）
• 保存设置后重启VSCode，或打开新终端执行python --version/python3 --version验证是否能正常识别版本

2. 在VSCode中手动指定Python解释器 #

• 按下Ctrl+Shift+P（Windows/Linux）或Cmd+Shift+P（Mac），输入Python: Select Interpreter
• 在弹出列表中选择已安装的Python版本；若列表无对应选项，点击Enter interpreter path...，手动浏览选中Python安装目录下的python.exe文件
• 操作完成后，VSCode会在工作区的.vscode/settings.json中自动生成配置，示例如下：

  {
      "python.pythonPath": "C:\\Users\\XXX\\AppData\\Local\\Programs\\Python\\Python311\\python.exe"
  }
  

3. 刷新VSCode终端的环境变量 #

• 若VSCode终端未同步系统环境变量更新，可手动刷新：
  • CMD终端输入：refreshenv
  • PowerShell输入：$env:Path = [System.Environment]::GetEnvironmentVariable("Path","Machine") + ";" + [System.Environment]::GetEnvironmentVariable("Path","User")
• 刷新后在终端执行python --version确认是否能识别

4. 重新安装Python并确保路径配置正确 #

• 卸载当前Python版本，下载官方安装包时务必勾选Add Python to PATH选项，选择自定义安装保证组件完整
• 安装完成后先在系统终端（非VSCode终端）执行python --version，确认系统能识别后再打开VSCode使用

5. 禁用VSCode的Python自动安装检测（可选） #

• 打开VSCode设置（快捷键Ctrl+,），搜索Python: Disable Installation Check并勾选该选项，避免VSCode自动跳转微软商店触发安装提示

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