Mac下使用pip持续报错的原因及解决方法

1. 多Python环境路径冲突：系统中同时存在Anaconda Python、独立Python 3.10和3.11，pip/pip3命令未与当前调用的python3（3.11）绑定，导致执行安装时实际调用的是其他环境的pip，往Anaconda目录写入；而pip list调用的是3.10的pip，出现版本不匹配、安装包不显示的问题。
2. pip命令优先级异常：which python3显示当前默认Python是3.11，但系统环境变量中，3.10或Anaconda的pip路径优先级更高，导致执行pip/pip3时实际调用的是其他版本的pip。

方法1：直接指定对应Python版本的pip执行命令 #

这是最直接避免环境冲突的方式，无需修改环境变量：

• 用Python 3.11的pip安装包：

  /Library/Frameworks/Python.framework/Versions/3.11/bin/python3 -m pip install [包名]
  

  需要升级包时，添加--upgrade参数：

  /Library/Frameworks/Python.framework/Versions/3.11/bin/python3 -m pip install --upgrade [包名]
  

• 查看Python 3.11环境的包列表：

  /Library/Frameworks/Python.framework/Versions/3.11/bin/python3 -m pip list
  

• 升级Python 3.11的pip到最新版：

  /Library/Frameworks/Python.framework/Versions/3.11/bin/python3 -m pip install --upgrade pip
  

方法2：调整环境变量，让pip默认关联Python 3.11 #

1. 打开终端，编辑shell配置文件（使用bash则编辑~/.bash_profile，使用zsh则编辑~/.zshrc）：

   nano ~/.bash_profile
   

2. 添加以下内容，将Python 3.11的bin目录放到环境变量最前端：

   export PATH="/Library/Frameworks/Python.framework/Versions/3.11/bin:$PATH"
   

3. 保存并退出（nano编辑器按Ctrl+O回车保存，再按Ctrl+X退出），然后刷新配置：

   source ~/.bash_profile
   

4. 验证生效：

   pip3 --version
   

   输出应显示对应Python 3.11的pip路径。

方法3：清理冗余环境（可选） #

如果不需要Anaconda或Python 3.10，可彻底卸载以避免后续冲突：

• 卸载Anaconda：删除~/anaconda3目录，再从~/.bash_profile/~/.zshrc中移除Anaconda相关的PATH配置。
• 卸载Python 3.10：删除/Library/Frameworks/Python.framework/Versions/3.10目录，再删除/usr/local/bin下对应的python3.10、pip3.10等软链接。

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