安装Python和VS Code后运行报错「Python was not found」该如何处理

报错信息：Python was not found; run without arguments to install from the Microsoft Store, or disable this shortcut from Settings > Manage App Execution Aliases

核心原因 #

该报错是Windows系统内置的Python应用安装别名优先级高于你手动安装的Python路径导致，系统调用Python时优先触发了微软商店的安装引导，即便你已经勾选了PATH配置、之前使用正常也可能出现该问题（多数是Windows系统更新后自动重置了别名配置导致）。

分步排查处理步骤 #

• 第一步：禁用Windows应用执行别名的Python快捷方式
  打开「设置」>「应用」>「高级应用设置」>「管理应用执行别名」，找到列表里「应用安装程序」对应的python.exe和python3.exe两个选项，全部关闭即可。
• 第二步：验证系统Python路径配置
  按下Win+R输入cmd打开命令提示符，依次执行以下命令：

  python --version
  pip --version
  

  如果能正常输出版本号说明系统路径配置正常；如果仍然提示找不到，手动把Python安装路径和对应Scripts路径加到系统环境变量PATH中：
  官方Python默认安装路径格式为C:\Users\你的用户名\AppData\Local\Programs\Python\Python对应版本号\，Scripts路径为上述目录下的Scripts文件夹。
• 第三步：匹配VS Code Python解释器
  打开VS Code后按下Ctrl+Shift+P调出命令面板，输入「Python: Select Interpreter」，在弹出的列表中选择你刚才验证过的官方Python版本即可，不要选择系统默认的虚包路径。
• 第四步：重启验证
  关闭所有已打开的命令提示符、VS Code窗口，重新打开VS Code运行测试代码即可。

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