VS Code运行Python报错求助：'python'命令未被识别

别着急，这个问题大多是Python没加入系统环境变量或者VS Code没关联到正确的Python解释器导致的，我给你一步步排查解决：

1. 先确认Python是否在系统环境变量里 #

打开系统的命令提示符（CMD），输入以下命令：

where python

或者针对Python3：

where python3

如果返回“找不到文件”，说明Python的安装路径没加到系统PATH里，得手动添加：

• 找到你的Python安装目录，比如默认路径是C:\Users\你的用户名\AppData\Local\Programs\Python\Python3xx（xx是你的版本号，比如311）
• 同时还要把该目录下的Scripts文件夹也加进去（比如C:\Users\你的用户名\AppData\Local\Programs\Python\Python3xx\Scripts）
• 右键“此电脑”→“属性”→“高级系统设置”→“环境变量”，在系统变量的PATH里添加上述两个路径，点击确定保存
• 重启CMD和VS Code，再输入python --version验证是否能识别

2. 在VS Code中指定正确的Python解释器 #

即使系统PATH没问题，VS Code也可能没自动识别到Python，手动指定一下：

• 打开VS Code，按下Ctrl+Shift+P（Windows/Linux）或Cmd+Shift+P（Mac）调出命令面板
• 输入Python: Select Interpreter，回车后选择你已经安装的Python3版本（比如Python 3.11.x 64-bit）
• 之后VS Code会在工作区的.vscode文件夹里生成settings.json，自动关联这个解释器

3. 调试时检查launch.json配置（如果用调试运行） #

如果你是通过调试按钮运行代码，可能launch.json里的路径不对：

• 打开.vscode/launch.json文件（如果没有，就点击调试面板的“创建launch.json文件”，选择Python环境）
• 确保command字段指向正确的Python路径，比如：

  "configurations": [
      {
          "name": "Python: Current File",
          "type": "python",
          "request": "launch",
          "program": "${file}",
          "console": "integratedTerminal",
          "command": "python3" // 或者具体路径如"C:/Users/xxx/AppData/Local/Programs/Python/Python311/python.exe"
      }
  ]
  

4. 尝试用python3代替python命令 #

有些环境里，Python3的命令是python3而不是python，可以在VS Code的终端里直接输入python3 --version测试，如果能识别，那可以：

• 打开VS Code的设置（Ctrl+,），搜索python.pythonPath，把值改成python3
• 或者在终端运行代码时，用python3 你的文件名.py代替python 你的文件名.py

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