Ubuntu 24.04迁移后pip命令失效的正规修复方法咨询

问题现象 #

• 直接执行pip命令报错：

svend@localhost:~$ pip
-bash: /home/svend/.local/bin/pip: cannot execute: required file not found

• 通过python -m pip调用则正常工作：

svend@localhost:~$ python -m pip --version
pip 24.0 from /usr/lib/python3/dist-packages/pip (python 3.12)

原因分析 #

迁移家目录时，旧Ubuntu 20.04环境下的.local/bin/pip脚本被同步过来，该脚本硬编码依赖Python 3.10（20.04默认版本），但Ubuntu 24.04默认Python版本为3.12，导致版本不兼容：

#!/usr/bin/python3.10
# -*- coding: utf-8 -*-
import re
import sys
from pip._internal.cli.main import main
if __name__ == '__main__':
    sys.argv[0] = re.sub(r'(-script\.pyw|\.exe)?$', '', sys.argv[0])
    sys.exit(main())

同时，which -a pip显示系统存在多个pip路径，用户目录下的旧脚本优先级高于全局路径：

svend@localhost:~$ which -a pip
/home/svend/.local/bin/pip
/usr/bin/pip
/bin/pip

规范解决方法 #

方法1：清理旧用户级脚本 #

直接重命名或删除.local/bin下的旧pip相关文件，让系统自动调用全局版本：

mv ~/.local/bin/pip ~/.local/bin/pip_old
mv ~/.local/bin/pip3 ~/.local/bin/pip3_old
mv ~/.local/bin/virtualenv ~/.local/bin/virtualenv_old

重启终端会话后即可正常使用pip命令。

方法2：重新生成适配当前版本的用户级pip（推荐） #

如果需要保留用户级pip环境，通过python -m pip重新安装并升级用户级pip，会自动生成适配Python 3.12的脚本：

python -m pip install --user --upgrade pip

注意事项 #

• 不要使用pip uninstall pip加--break-system-packages参数，这会破坏系统自带的Python环境，This environment is externally managed是系统的保护机制。
• 若需要使用virtualenv，建议重新安装用户级版本：

python -m pip install --user virtualenv

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