应直接安装python3而不覆盖系统默认python,ubuntu/debian用apt install python3,centos/rhel用dnf install python3,旧系统推荐pyenv或编译到/opt;切换默认python须用update-alternatives;源码编译需装齐依赖、加--enable-optimizations和--prefix、用make altinstall;pip报distutils错误需升级pip。

直接装 python3 而不是覆盖系统默认的 python
Ubuntu/Debian 系统自带的 python(通常是 python2.7)被很多系统工具依赖,比如 apt、systemd 的部分脚本。强行把 /usr/bin/python 指向 python3,可能让包管理器报错甚至无法更新。所以正确做法是保留原 python,只装好 python3 并用它执行自己的代码。
实操建议:
- Ubuntu/Debian 直接运行
sudo apt update && sudo apt install python3 python3-pip—— 大多数版本已预装,这条命令只是确保最新 - CentOS/RHEL 8+ 默认有
python3,但需手动启用:运行sudo dnf install python3 python3-pip - CentOS 7 或旧系统没有
python3?别用make install覆盖/usr/bin,改用pyenv或编译到/opt/python3.x,再加进$PATH - 验证是否装对:运行
python3 --version,别输python --version—— 后者很可能还是 2.7
update-alternatives 是唯一安全切换默认 python 的方式
有些项目硬写死调用 python 命令,又不想改代码,这时才需要“切换默认”。但必须用系统级机制,不能简单 ln -sf,否则升级系统时会被覆盖或引发冲突。
实操建议:
- 先确认已安装多个版本:比如
python3.9和python3.11都在/usr/bin/下 - 注册它们:
sudo update-alternatives --install /usr/bin/python python /usr/bin/python3.9 1,再加一条--install注册python3.11,优先级设为 2 - 交互式切换:
sudo update-alternatives --config python,选数字即可。此时python --version才会变 - 注意:这个操作不影响
python3命令本身,它始终指向具体版本;只影响未带数字的python
源码编译 Python3 时最容易踩的三个坑
官方 tarball 编译看似自由,但跳过关键步骤会导致 pip 不可用、SSL 失败、中文路径乱码等隐性问题。
实操建议:
- 编译前必须装齐依赖:
sudo apt install -y build-essential zlib1g-dev libncurses5-dev libgdbm-dev libnss3-dev libssl-dev libreadline-dev libsqlite3-dev wget curl llvm libbz2-dev(Ubuntu/Debian)。缺libssl-dev就没有 HTTPS 支持,pip install会卡住 -
./configure一定要加--enable-optimizations(提升性能)和--prefix=/opt/python3.12(避免污染系统目录) - 别用
make install,改用make altinstall—— 这能防止覆盖系统自带的python和python3命令 - 装完立刻验证:
/opt/python3.12/bin/python3.12 -c "import ssl; print(ssl.OPENSSL_VERSION)",不报错才算 SSL 正常
升级后 pip 报错 ModuleNotFoundError: No module named 'distutils'
这是 Python 3.12+ 移除了内置 distutils,但老版 pip 还在尝试导入。不是你装错了,是 pip 版本太旧,和新 Python 不兼容。
实操建议:
- 先用系统自带 pip 升级自己:
python3 -m pip install --upgrade pip - 如果失败,下载 get-pip.py 手动装:
curl https://bootstrap.pypa.io/get-pip.py | python3.12 - 检查
pip是否绑定对了 Python:pip --version输出里必须含python3.12,而不是python3.8 - 某些发行版(如 Ubuntu)的
python3-pip包滞后,建议弃用,全程用python3 -m pip调用
真正麻烦的不是装不上,而是装上之后没意识到 python、python3、pip、pip3 四个命令背后可能指向不同解释器和库路径。查清楚每个命令的 which 和 python -m site 输出,比盲目升级重要得多。
Python免费学习笔记(深入):立即使用
在学习笔记中,你将探索 Python 的核心概念和高级技巧!










