Big Sur系统下pyenv-virtualenv环境pip安装包到全局路径问题排查

你遇到的问题核心是pip命令被设置了shell别名，优先级高于pyenv的shims路径查找：

• shell执行命令时别名优先级最高，你配置的alias pip=/usr/local/bin/pip3直接将pip指令绑定到了全局pip3，完全绕过了pyenv的虚拟环境路径匹配
• 你查到的pyenv包装函数是pyenv-virtualenv插件初始化生成的，属于正常配置，无故障
• PATH开头的zsh临时缓存目录是系统自动生成的，目录下不存在pip可执行文件，不影响当前问题

• 执行alias | grep pip确认所有和pip相关的别名配置，确认是否有绑定全局路径的规则
• 检查所有zsh配置文件（~/.zshrc、~/.zprofile、~/.zsh_aliases、/etc/zshrc），定位别名配置的来源，升级Big Sur后部分系统默认配置或旧的自定义配置可能会自动添加pip别名
• 移除别名后执行type pip，确认返回结果为/Users/mikekilmer/.pyenv/shims/pip，代表pyenv的shims已正常接管pip命令

1. 移除pip全局别名
   打开对应的zsh配置文件，删除或注释alias pip=/usr/local/bin/pip3这类绑定全局路径的配置，之后执行source ~/.zshrc让配置生效。
2. 验证虚拟环境pip路径
   进入项目目录激活虚拟环境后，执行以下命令确认路径匹配：

which pip
# 预期输出和pyenv which pip结果一致：/Users/mikekilmer/.pyenv/versions/3.9.5/envs/project_venv/bin/pip
pyenv which pip

3. 可选：修复pyenv初始化配置
   如果移除别名后仍有问题，确认你的~/.zshrc中pyenv初始化代码顺序正确：

export PYENV_ROOT="$HOME/.pyenv"
export PATH="$PYENV_ROOT/bin:$PATH"
eval "$(pyenv init -)"
eval "$(pyenv virtualenv-init -)"

调整后重启终端即可生效。如果不想修改别名，也可以直接使用pip3命令执行安装操作，当前你的pip3已正常被pyenv shims接管，安装路径会自动匹配虚拟环境。

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