VS Code终端未使用指定Python解释器问题求助

1. 检查终端的Python路径优先级 #

• 打开VSCode终端，输入where python，查看输出的路径列表，确认系统自带Python路径是否排在ESRI Python路径的前面。
• 若顺序错误，调整系统环境变量：
  1. 右键「此电脑」→「属性」→「高级系统设置」→「环境变量」
  2. 在「系统变量」的Path列表中，将ESRI的Python安装路径（示例：C:\Program Files\ArcGIS\Pro\bin\Python\envs\arcgispro-py3）拖动到系统自带Python路径的上方
  3. 重启VSCode，再次输入where python确认路径顺序已调整

2. 确保VSCode终端自动激活目标环境 #

• 打开VSCode设置（快捷键Ctrl+,），搜索python.terminal.activateEnvironment，确认该选项处于勾选状态。
• 若仍未生效，手动配置终端激活命令：
  1. 找到ESRI Python环境的激活脚本，路径一般为[ESRI Python路径]\Scripts\activate.bat
  2. 点击终端面板右上角的下拉箭头→「选择默认配置文件」→选中你使用的终端（如Command Prompt）→「编辑配置文件」
  3. 在配置的args字段中添加激活命令，示例：["/k", "C:\\Program Files\\ArcGIS\\Pro\\bin\\Python\\envs\\arcgispro-py3\\Scripts\\activate.bat"]
  4. 保存配置后重启终端，再运行脚本测试

3. 直接使用解释器绝对路径运行脚本 #

• 不想修改环境变量的话，运行脚本时直接指定ESRI Python的绝对路径：

  "C:\Program Files\ArcGIS\Pro\bin\Python\envs\arcgispro-py3\python.exe" your_script.py
  

• 可以将此命令配置为VSCode自定义快捷键：
  1. 打开快捷键设置（Ctrl+K Ctrl+S），搜索「run script」
  2. 点击「添加快捷键」，绑定你习惯的快捷键（如Ctrl+Shift+R）
  3. 或者通过tasks.json配置：在项目的.vscode文件夹下创建tasks.json，内容如下：

     {
         "version": "2.0.0",
         "tasks": [
             {
                 "label": "Run with ESRI Python",
                 "type": "shell",
                 "command": "\"C:\\Program Files\\ArcGIS\\Pro\\bin\\Python\\envs\\arcgispro-py3\\python.exe\" ${file}",
                 "group": {
                     "kind": "build",
                     "isDefault": true
                 },
                 "problemMatcher": []
             }
         ]
     }
     

     之后将快捷键绑定到workbench.action.tasks.runBuildTask即可

4. 重新确认VSCode的解释器配置 #

• 查看VSCode右下角显示的解释器名称，点击它重新选择一次ESRI的Python环境，确保没有选错
• 打开.vscode/settings.json，检查是否包含以下配置：

  "python.defaultInterpreterPath": "C:\\Program Files\\ArcGIS\\Pro\\bin\\Python\\envs\\arcgispro-py3\\python.exe",
  "python.terminal.activateEnvironment": true
  

  若缺失，手动添加后保存

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