VS Code运行Python代码提示'python'不是内部或外部命令如何解决

核心排查&修复步骤 #

• 先校验系统环境变量配置有效性
  1. 先定位本地Python实际安装路径，默认安装路径通常为：
     • C:\Users\你的系统用户名\AppData\Local\Programs\Python\Python3xx\（xx为具体版本号，如Python3.10对应Python310）
     • C:\Program Files\Python3xx\
       进入对应路径确认存在python.exe文件，同时记录同目录下Scripts文件夹的完整路径。
  2. 右键「此电脑」→「属性」→「高级系统设置」→「环境变量」，在系统变量列表中找到Path条目，点击编辑，把刚才记录的Python根目录路径、Scripts目录路径都新增进去，所有设置窗口逐一点击「确定」保存，不要直接点右上角叉号关闭。
  3. 按Win+R输入cmd打开全新的命令提示符窗口（旧窗口不会加载更新后的环境变量），执行python --version，如果能正常返回Python版本号，说明系统层面配置已生效。
• 修复VS Code侧配置问题
  1. 完全退出VS Code（任务管理器里确认无残留Code进程）后重新打开软件，避免旧进程缓存旧配置。
  2. 打开任意Python文件，点击VS Code窗口右下角的解释器选择栏，手动选中你刚才找到路径下的python.exe，不要使用自动识别的未知路径解释器。
  3. 若安装了Code Runner扩展，打开设置搜索Code-runner: Executor Map，点击进入settings.json编辑，找到python对应的执行配置，将默认的python替换为你本地python.exe的完整路径，参考配置如下：

     "code-runner.executorMap": {
         "python": "\"C:\\Users\\yourname\\AppData\\Local\\Programs\\Python\\Python311\\python.exe\" -u"
     }
     

• 排查Windows特有坑点
  打开系统设置→「应用」→「高级应用设置」→「应用执行别名」，找到列表里的python.exe、python3.exe两个条目，把对应的开关全部关掉——这个别名默认会把python命令重定向到微软商店，优先级高于你自己安装的Python，很多人重装多次都卡在这里。

注意：所有配置修改完成后，一定要在VS Code里新建终端标签再运行代码，旧终端不会加载新的环境变量和配置，会持续报原错误。

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