如何在VSCode的ZSH终端中自动激活Python虚拟环境venv

1. 排查Zsh启动脚本的干扰 #

VSCode的Python插件会在终端初始化时自动注入source venv/bin/activate命令，但如果你的~/.zshrc或项目本地的Zsh配置中有重置PATH、覆盖环境变量的操作，会直接冲掉虚拟环境的激活状态。比如常见的export PATH=/usr/bin:$PATH这类语句，会把全局Python路径优先级提至虚拟环境之上。

解决办法：

• 打开~/.zshrc，检查是否有修改PATH的代码，调整顺序让虚拟环境路径优先，或者添加判断仅在非VSCode终端执行这类操作：

  # 仅在非VSCode启动的终端中重置PATH
  if [[ ! "$TERM_PROGRAM" == "vscode" ]]; then
      export PATH=/usr/bin:$PATH
  fi
  

• 保存后重启VSCode终端，验证是否生效。

2. 修正VSCode的Zsh配置 #

你之前自定义终端profile的方式可能引发冲突，VSCode的Python插件本身会处理激活逻辑，无需手动在终端参数中添加source命令。正确的配置如下：
打开src/.vscode/settings.json，确保内容为：

{
    "python.terminal.activateEnvironment": true,
    "terminal.integrated.defaultProfile.linux": "zsh",
    "terminal.integrated.profiles.linux": {
        "zsh": {
            "path": "/bin/zsh",
            "args": []
        }
    },
    "terminal.integrated.env.linux": {}
}

重点：清空terminal.integrated.env.linux，避免它覆盖虚拟环境的环境变量；不要在args中手动添加激活命令。

3. 处理终端行尾的特殊符号 #

行尾的特殊符号通常是Zsh提示符（PS1）被破坏导致的，可能和虚拟环境激活后的提示符注入冲突。可以尝试：

• 在~/.zshrc中重置提示符：

  PS1="%n@%m %~ %# "
  

• 或者暂时关闭VSCode的shell集成功能，在settings.json中添加：

  "terminal.integrated.shellIntegration.enabled": false
  

4. 验证激活逻辑 #

• 打开VSCode终端后，执行echo $VIRTUAL_ENV，如果输出src/venv则说明激活成功；如果为空，查看VSCode的「输出」面板（选择Python日志），检查是否有激活命令注入失败的报错信息。
• 确认VSCode打开的是src根文件夹，而非上层目录，确保虚拟环境的相对路径正确。

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