VSCode Zsh与iTerm Zsh PATH不一致，pip3指向异常求助

现象对比 #

VSCode内置Zsh的PATH #

(base) ➜ ~ echo $PATH | tr ":" "\n"
/opt/homebrew/bin
/usr/local/bin
/System/Cryptexes/App/usr/bin
/usr/bin
/bin
/usr/sbin
/sbin
/var/run/com.apple.security.cryptexd/codex.system/bootstrap/usr/local/bin
/var/run/com.apple.security.cryptexd/codex.system/bootstrap/usr/bin
/var/run/com.apple.security.cryptexd/codex.system/bootstrap/usr/appleinternal/bin
/Users/myname/miniconda3/bin
/Users/myname/miniconda3/condabin
/opt/homebrew/bin

iTerm中Zsh的PATH #

(base) ➜ ~ echo $PATH | tr ":" "\n"
/Users/myname/miniconda3/bin
/Users/myname/miniconda3/condabin
/opt/homebrew/bin
/usr/local/bin
/System/Cryptexes/App/usr/bin
/usr/bin
/bin
/usr/sbin
/sbin
/var/run/com.apple.security.cryptexd/codex.system/bootstrap/usr/local/bin
/var/run/com.apple.security.cryptexd/codex.system/bootstrap/usr/bin
/var/run/com.apple.security.cryptexd/codex.system/bootstrap/usr/appleinternal/bin

导致的问题 #

在VSCode的Zsh中，即使激活了conda的base环境，执行which pip3仍指向Homebrew版本：

(base) ➜ ~ which pip3
/opt/homebrew/bin/pip3

当前.zshrc配置 #

export PATH=/opt/homebrew/bin:$PATH
alias pip=pip3

# >>> conda initialize >>>
# !! Contents within this block are managed by 'conda init' !!
__conda_setup="$('/Users/myname/miniconda3/bin/conda' 'shell.zsh' 'hook' 2> /dev/null)"
if [ $? -eq 0 ]; then
    eval "$__conda_setup"
else
    if [ -f "/Users/myname/miniconda3/etc/profile.d/conda.sh" ]; then
        . "/Users/myname/miniconda3/etc/profile.d/conda.sh"
    else
        export PATH="/Users/mgname/miniconda3/bin:$PATH"
    fi
fi
unset __conda_setup
# <<< conda initialize <<<

解决方案 #

问题核心是conda初始化代码在Homebrew的PATH配置之后，导致Homebrew路径优先级高于conda；同时VSCode可能额外加载环境变量，造成/opt/homebrew/bin重复添加。

修改步骤 #

1. 调整PATH配置顺序，将Homebrew的PATH添加逻辑移到conda初始化之后
2. 修正配置中的拼写错误：/Users/mgname/miniconda3/bin改为/Users/myname/miniconda3/bin
3. 确保VSCode终端继承系统环境：打开设置，将terminal.integrated.inheritEnv设为true

修改后的.zshrc #

# >>> conda initialize >>>
# !! Contents within this block are managed by 'conda init' !!
__conda_setup="$('/Users/myname/miniconda3/bin/conda' 'shell.zsh' 'hook' 2> /dev/null)"
if [ $? -eq 0 ]; then
    eval "$__conda_setup"
else
    if [ -f "/Users/myname/miniconda3/etc/profile.d/conda.sh" ]; then
        . "/Users/myname/miniconda3/etc/profile.d/conda.sh"
    else
        export PATH="/Users/myname/miniconda3/bin:$PATH"
    fi
fi
unset __conda_setup
# <<< conda initialize <<<

# 将Homebrew路径追加到PATH末尾，确保conda路径优先级更高
export PATH="$PATH:/opt/homebrew/bin"
alias pip=pip3

修改完成后，重启VSCode内置终端，执行echo $PATH即可看到与iTerm一致的路径顺序，此时which pip3会指向/Users/myname/miniconda3/bin/pip3。

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