MacOS下VSCode终端无法自动激活.venv虚拟环境问题求助

可能原因 #

VSCode的自动激活功能仅修改了命令行提示符，未正确将虚拟环境的bin目录加入PATH最前端，导致which命令仍然指向pyenv的shims路径；同时手动激活时会重复加载激活脚本，出现双提示符。

解决步骤 #

1. 确认VSCode的Python解释器选择正确 #

打开VSCode左下角的Python解释器选择器，确保选中的是项目根目录下的.venv/bin/python，而非pyenv全局/本地版本的Python。

2. 调整VSCode终端的启动配置 #

打开VSCode设置（快捷键Cmd+,），搜索terminal.integrated.profiles.osx，点击编辑 in settings.json，修改zsh（或你使用的shell）的配置，让终端启动时自动检测并激活项目的虚拟环境：

"terminal.integrated.profiles.osx": {
    "zsh": {
        "path": "/bin/zsh",
        "args": ["-c", "if [ -d .venv ]; then source .venv/bin/activate; fi; exec zsh"]
    }
},
"terminal.integrated.defaultProfile.osx": "zsh"

这个配置会让终端启动时先检查当前目录是否有.venv文件夹，有就激活，然后再启动shell。

3. 关闭VSCode自带的自动激活设置 #

之前开启的Python: Activate Env in Current Terminal和Python: Activate Environment可能和手动激活逻辑冲突，建议关闭这两项设置，避免重复修改提示符和环境变量。

4. 验证修复效果 #

重启VSCode，打开终端：

• 执行which python和which pip，应该返回./.venv/bin/python和./.venv/bin/pip
• 手动执行source .venv/bin/activate不会再出现双提示符

额外排查点 #

如果上述方法无效，检查你的shell配置文件（如~/.zshrc），确保pyenv的初始化代码（比如eval "$(pyenv init -)"）没有覆盖PATH中虚拟环境的路径。可以将pyenv的初始化代码放在配置文件的末尾，确保虚拟环境激活后添加的路径优先级更高。

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