VSCode终端无法识别python、pip命令的原因及修复方法

问题原因 #

• VSCode终端未继承系统完整PATH：从你描述的PATH差异来看，VSCode的终端没有正确加载系统级PATH，ArcGIS Pro的环境配置大概率覆盖或干扰了PATH的继承逻辑。
• Python解释器路径未加入终端会话PATH：即便VSCode能识别到Python解释器，当前终端会话的PATH里没有包含对应Python和pip的存放路径，导致命令无法被系统找到。

修复步骤 #

• 开启终端环境变量继承
  打开VSCode设置（快捷键Ctrl+,），搜索terminal.integrated.inheritEnv，确保该选项处于勾选状态，让终端继承系统的完整环境变量。

• 手动添加Python路径到终端

  1. 通过Ctrl+Shift+P打开命令面板，执行Python: Select Interpreter选择你的Python 3.11版本。
  2. 在VSCode终端中执行以下命令（替换为你的Python实际安装路径）：

     $env:PATH += ";C:\Users\你的用户名\AppData\Local\Programs\Python\Python311;C:\Users\你的用户名\AppData\Local\Programs\Python\Python311\Scripts"
     

     执行后测试python --version和pip --version是否正常。

• 调整系统PATH顺序

  1. 右键「此电脑」→「属性」→「高级系统设置」→「环境变量」。
  2. 在系统PATH列表中，找到Python 3.11的安装路径和Scripts路径，将它们移到ArcGIS相关路径的上方，确保系统优先识别Python命令。
  3. 重启VSCode后再次测试终端。

• 重置VSCode终端配置
  如果以上方法无效，可删除VSCode的用户配置文件（路径：C:\Users\你的用户名\AppData\Roaming\Code\User\settings.json），重启VSCode后重新选择Python解释器。

内容的提问来源于stack exchange，提问作者W. Kessler