如何启动VSCode会话时自动激活指定virtualenv？

问题背景 #

我平时用VSCode编码时，经常需要在当前virtualenv环境的终端里操作，但每次新建终端都得手动激活对应的virtualenv，而且每天要多次切换环境，太浪费时间。

之前试过写bash脚本激活virtualenv后再启动VSCode，但脚本不稳定：有时候新建终端没激活环境，有时候还保留着上次的环境。这个脚本绑定了快捷键，传入路径参数执行（比如按CTRL+SHIFT+D激活日常测试环境），但脚本误以为启动VSCode前激活的virtualenv会被终端继承，实际上VSCode根本不识别启动前激活的环境。

我需要一个简单的方法，启动VSCode会话时就自动激活指定的virtualenv，不用每次新建终端手动激活，而且不把virtualenv和特定项目、文件、工作区或仓库绑定，只针对当前VSCode会话——也就是每次启动VSCode用一个virtualenv，切换环境就重启VSCode。

附上之前使用的脚本：

#!/bin/bash
echo --------------------------  virtualenv: daily tests --------------------------
echo "changing to path: $1"
cd $1
echo --------------------------  Activate VirtualEnv --------------------------
echo Activate Virtual Environment at:
echo    /home/user/.virtualenvs/VirtEnvRG001_daily_tests/bin/activate
source /home/user/.virtualenvs/VirtEnvRG001_daily_tests/bin/activate
echo Wait 1 s
sleep 1
echo Calling VSC...
code $1

可行解决方案 #

方法1：修改启动脚本（推荐） #

直接调整bash脚本，无需提前激活virtualenv，而是通过传递环境变量让VSCode自动识别并激活目标环境：

#!/bin/bash
VENV_PATH="/home/user/.virtualenvs/VirtEnvRG001_daily_tests"
TARGET_PATH="$1"

echo --------------------------  virtualenv: daily tests --------------------------
echo "Target path: $TARGET_PATH"
echo "Virtualenv path: $VENV_PATH"

# 设置环境变量，让VSCode集成终端自动激活virtualenv
export VIRTUAL_ENV="$VENV_PATH"
export PATH="$VENV_PATH/bin:$PATH"

echo Starting VSCode...
code "$TARGET_PATH"

原理：VSCode的集成终端会自动检测VIRTUAL_ENV环境变量，若存在则在终端启动时自动激活对应环境；同时将virtualenv的bin目录放在PATH最前面，确保终端优先使用环境内的Python、pip等工具。

方法2：临时修改VSCode用户配置（可选） #

如果不想修改脚本，可通过临时配置VSCode终端环境变量实现，但该方法为全局配置，切换环境需修改配置后重启VSCode：

1. 打开VSCode用户设置（快捷键Ctrl+,）
2. 搜索terminal.integrated.env.linux（Windows对应windows，macOS对应osx）
3. 添加如下配置：

"terminal.integrated.env.linux": {
    "VIRTUAL_ENV": "/home/user/.virtualenvs/VirtEnvRG001_daily_tests",
    "PATH": "/home/user/.virtualenvs/VirtEnvRG001_daily_tests/bin:${env:PATH}"
}

4. 保存配置后重启VSCode，新建终端会自动激活指定virtualenv。

验证方式 #

启动VSCode后新建终端，执行以下命令验证：

• echo $VIRTUAL_ENV：应显示指定的virtualenv路径
• which python：应指向该virtualenv目录下的Python可执行文件

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