VSCode终端已激活虚拟环境却仍使用错误Python解释器

核心原因 #

VSCode的Python解释器选择与终端shell环境是两个独立机制：

• 编辑器层面选中的解释器仅用于代码补全、调试、内置运行功能，不会自动激活终端内的虚拟环境。
• 终端的shell（zsh）环境独立于编辑器，默认继承系统/全局环境变量，未激活虚拟环境时，PATH优先级仍偏向全局Python。

对应现象拆解 #

1. VSCode显示选中正确解释器，但终端which python返回全局路径：
   编辑器的解释器设置不修改终端的PATH变量，终端默认使用全局环境，因此未手动激活时，全局Python优先被识别。

2. VSCode终端执行poetry shell报错已激活但找不到包：
   Poetry的poetry shell通过修改shell环境变量激活虚拟环境，但VSCode终端可能因环境继承问题，导致Poetry误判虚拟环境"已激活"，而实际shell未加载虚拟环境的PATH，因此无法找到安装的包。

3. deactivate权限拒绝：
   deactivate是虚拟环境激活后生成的shell函数，并非可执行文件。直接执行deactivate报错，说明当前shell根本未激活虚拟环境，zsh将其视为可执行文件，自然触发权限不足提示。

4. 外部终端（WezTerm）poetry shell正常：
   外部终端的shell环境未被VSCode的终端配置干扰，Poetry能正常检测并修改环境变量完成虚拟环境激活。

解决方案 #

1. 开启VSCode终端自动激活虚拟环境 #

在VSCode设置中启用python.terminal.activateEnvironment，让终端打开时自动激活当前选中的虚拟环境：

• 打开VSCode设置（快捷键Cmd+,）
• 搜索python.terminal.activateEnvironment
• 勾选该选项，重启VSCode终端

2. 检查VSCode的shell配置 #

确保VSCode终端使用正确的shell并加载完整配置：

• 搜索terminal.integrated.defaultProfile.osx，确认选中zsh
• 搜索terminal.integrated.shellArgs.osx，移除可能干扰环境变量的参数
• 重启VSCode，让终端重新加载shell配置

3. 手动配置自动激活（可选） #

若上述方法无效，可在全局.zshrc或项目本地配置中添加自动激活脚本：

# 进入项目目录时自动激活.venv虚拟环境
if [ -d ".venv" ]; then
    source .venv/bin/activate
fi

也可使用direnv工具，通过项目目录下的.envrc文件实现自动激活。

4. 验证激活状态 #

激活后执行以下命令确认：

echo $VIRTUAL_ENV  # 应输出项目的.venv路径
which python       # 应输出./.venv/bin/python
pip list           # 应显示Poetry安装的包

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