使用pyenv-virtualenv时VSCode Tasks无法激活虚拟环境的问题

问题背景 #

已完成pyenv环境配置，VSCode内置终端可自动加载正确的pyenv虚拟环境并执行代码，但运行VSCode Tasks时无法激活项目对应的pyenv虚拟环境。

环境配置 #

项目终端正常输出 #

(proj) % pyenv local
projenv
(proj) % python --version
Python 3.10.4

尝试的.vscode/tasks.json配置 #

{
    "version": "2.0.0",
    "tasks": [
        {
            "label": "Run some python",
            "type": "shell",
            "command": "pyenv activate projenv && python --version",
        }
    ]
}

相关shell配置文件 #

~/.zprofile内容：

echo "Hello .zprofile"

~/.zshrc内容：

echo "Hello .zshrc"
export PYENV_ROOT="$HOME/.pyenv"
command -v pyenv >/dev/null || export PATH="$PYENV_ROOT/bin:$PATH"
eval "$(pyenv init -)"

问题现象 #

• 第一次执行任务输出：

Python 2.7.18

• 第二次执行同任务输出：

Failed to activate virtualenv.
Perhaps pyenv-virtualenv has not been loaded into your shell properly.
Please restart current shell and try again.

• 运行Tasks时仅能看到Hello .zprofile输出，无法看到.zshrc中的Hello .zshrc；但手动新建VSCode终端时两者都会输出。
• 将pyenv激活配置复制/移动到.zprofile后，Tasks可正常激活虚拟环境并运行。

原因分析 #

VSCode Tasks执行shell命令时，默认以非交互式、非登录shell模式运行。zsh的配置文件加载规则如下：

• 登录shell（如手动打开终端）：会先加载.zprofile，随后加载.zshrc
• 非交互式非登录shell（如Tasks调用的shell）：仅会自动加载.zprofile，不会加载.zshrc

由于pyenv的初始化逻辑eval "$(pyenv init -)"放在.zshrc中，Tasks运行时未加载该文件，导致pyenv无法正确初始化，进而无法激活虚拟环境。

解决方法 #

1. 迁移pyenv配置到.zprofile（已验证有效）：将.zshrc中pyenv相关的配置代码复制到.zprofile中，确保Tasks运行时能加载到pyenv初始化逻辑。
2. 手动在Tasks中加载.zshrc：修改tasks.json的command，先手动source.zshrc再执行命令：

{
    "version": "2.0.0",
    "tasks": [
        {
            "label": "Run some python",
            "type": "shell",
            "command": "source ~/.zshrc && pyenv activate projenv && python --version",
        }
    ]
}

3. 强制Tasks使用交互式shell：在tasks.json中指定shell参数为交互式模式，让zsh加载.zshrc：

{
    "version": "2.0.0",
    "tasks": [
        {
            "label": "Run some python",
            "type": "shell",
            "command": "pyenv activate projenv && python --version",
            "options": {
                "shell": {
                    "executable": "zsh",
                    "args": ["-i", "-c"]
                }
            }
        }
    ]
}

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