MacOS下VSCode内置终端选对conda环境仍无法导入已安装Python包

问题根源 #

你遇到的问题是VSCode内置终端的PATH优先级异常导致的：虽然终端提示符显示(tf20)环境已激活，但实际调用python命令时，系统优先匹配到了没有安装numpy的系统Python，而非tf20环境内的Python。F5调试正常是因为调试功能会直接调用你选择的解释器的绝对路径/Users/mac/.jackprogram/anaconda3/envs/tf20/bin/python，绕过了终端的PATH查找逻辑。

排查步骤 #

首先在VSCode内置的已激活(tf20)的终端中执行以下命令确认问题：

• 执行which python，如果输出不是/Users/mac/.jackprogram/anaconda3/envs/tf20/bin/python，即可确认是PATH匹配问题
• 执行echo $PATH，查看tf20环境的bin目录是否在输出列表的最前列，如果不在说明conda激活未正确修改PATH

修复方案 #

按优先级依次尝试以下方案：

方案1：关闭Python插件自动激活环境功能 #

1. 按下cmd + ,打开VSCode设置页，搜索python.terminal.activateEnvironment，取消该项的勾选
2. 关闭所有已打开的VSCode内置终端，重新打开一个终端，手动执行conda activate tf20激活环境后再运行脚本即可

方案2：配置Python命令别名 #

如果方案1无效，可直接固定Python命令的指向：

1. 打开macOS终端，执行open ~/.zshrc（如果用bash就打开~/.bash_profile）
2. 在文件末尾添加一行：alias python="/Users/mac/.jackprogram/anaconda3/envs/tf20/bin/python"
3. 执行source ~/.zshrc生效，重启VSCode终端后即可正常使用

方案3：重置工作区解释器配置 #

1. 按下cmd + shift + p调出命令面板，执行Python: Clear Workspace Interpreter Settings清除当前工作区的解释器缓存
2. 重新通过命令面板执行Python: Select Interpreter选择tf20环境，重启VSCode后再测试

效果验证 #

修复完成后在VSCode内置终端执行python -c "import numpy; print(numpy.__version__)"，输出1.18.5即代表修复成功。

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