Mac M1下pyenv环境pip版本不一致问题求助

问题现象 #

• 执行python -m pip -V显示pip版本为23.1，路径为/Users/mypc/.pyenv/versions/3.11.1/lib/python3.11/site-packages/pip
• 执行python -m pip show pip显示版本为23.0.1，路径与上面一致
• 查看site-packages目录，发现pip文件夹的__init__.py中__version__为23.1，但同时存在多个pip版本的dist-info文件夹：pip-22.3.1.dist-info、pip-23.0.1.dist-info、pip-23.0.dist-info、pip-23.1.dist-info
• 找不到pyenv环境对应的pip.conf文件

解决步骤 #

1. 清理冗余的dist-info文件夹 #

冗余的dist-info文件夹是版本显示不一致的核心原因，直接清理即可：

• 激活目标pyenv环境：

  pyenv activate 3.11.1
  

• 进入site-packages目录：

  cd /Users/mypc/.pyenv/versions/3.11.1/lib/python3.11/site-packages
  

• 删除除pip-23.1.dist-info之外的所有pip相关dist-info文件夹：

  rm -rf pip-22.3.1.dist-info pip-23.0.dist-info pip-23.0.1.dist-info
  

• 执行python -m pip show pip验证版本是否统一为23.1

2. 强制重装pip（清理后仍有问题时用） #

如果清理后版本还是不一致，强制重新安装对应版本的pip：

python -m pip install --force-reinstall pip==23.1

执行完后再用python -m pip -V和python -m pip show pip确认版本一致

3. 定位/创建pip.conf文件 #

pyenv环境下的pip配置文件按以下优先级查找：

• 当前项目根目录下的pip.conf
• 用户目录下的~/.pip/pip.conf（Mac/Linux通用）
• 系统级的/etc/pip.conf
  如果找不到，手动创建用户级配置文件即可：

mkdir -p ~/.pip
touch ~/.pip/pip.conf

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