启动iTerm2+zsh时zsh-autoswitch-virtualenv因Python未找到报错求助

问题现象 #

启动iTerm2的zsh shell时，收到插件提示：

WARNING: python binary not found on PATH.
zsh-autoswitch-virtualenv plugin will be disabled.

相关环境信息：

• 执行echo $PATH输出：

/Users/macm1/opt/anaconda3/bin:/Users/macm1/opt/anaconda3/condabin:/usr/local/bin:/Users/macm1/Library/Python/3.8/bin:/Users/macm1/.pyenv/bin:/Users/macm1/.pyenv/bin:/opt/local/bin:/opt/local/sbin:/opt/homebrew/bin:/opt/homebrew/sbin:/Library/Frameworks/Python.framework/Versions/3.10/bin:/usr/local/bin:/usr/bin:/bin:/usr/sbin:/sbin:~/.dotnet/tools:/Library/Apple/usr/bin:/Library/Frameworks/Mono.framework/Versions/Current/Commands:/Users/macm1/.fig/bin:/Users/macm1/.local/bin:/Users/macm1/.local/bin:/Users/macm1/.local/bin

• which python3结果：/Users/macm1/opt/anaconda3/bin/python3
• python --version结果：Python 3.9.7
• /usr/bin/python不存在

原因分析 #

zsh-autoswitch-virtualenv插件默认查找名为python的可执行文件，但你的系统中/usr/bin/python不存在（新macOS默认仅提供python3）；虽然你能正常执行python命令，大概率是conda环境提供的别名，但插件加载时conda初始化逻辑尚未完成，导致插件无法识别到python二进制文件。

解决方法 #

方法1：创建python到python3的软链接 #

在已加入PATH的目录中创建软链接，让系统能找到名为python的可执行文件：

• 系统级链接（需sudo权限）：

sudo ln -s /Users/macm1/opt/anaconda3/bin/python3 /usr/local/bin/python

• 用户个人目录链接（无需sudo）：

ln -s /Users/macm1/opt/anaconda3/bin/python3 ~/.local/bin/python

~/.local/bin已在你的PATH中，软链接创建后插件就能找到python。

方法2：指定插件的Python路径 #

在.zshrc中添加环境变量，直接告诉插件使用指定的python3路径：

export AUTOSWITCH_VIRTUALENV_PYTHON=/Users/macm1/opt/anaconda3/bin/python3

添加后执行source ~/.zshrc重新加载配置，下次启动时插件会直接使用该路径。

方法3：调整.zshrc中conda初始化的顺序 #

你的.zshrc中conda初始化逻辑在PATH配置之后，可能导致插件加载时conda的python别名尚未生效。将conda初始化块移到所有PATH配置之前，确保conda的路径优先被加载。

同时可清理.zshrc中重复的配置，保留一行即可：

export PYENV_ROOT="$HOME/.pyenv"
export PATH="$PYENV_ROOT/bin:$PATH"

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