Linux下安装与升级Python3全攻略

本文详解了在Linux系统中安全安装、管理和升级Python3的完整实践方案，强调绝不能覆盖系统默认的Python（尤其是Python2.7），以免破坏apt、systemd等关键工具；推荐Ubuntu/Debian用apt、CentOS/RHEL用dnf直接安装python3，旧系统优先选用pyenv或源码编译至/opt并配合make altinstall；深入讲解了通过update-alternatives安全切换默认python命令的方法，剖析了源码编译时必须满足的依赖、configure参数和常见陷阱（如SSL缺失、pip失效），并针对性解决了Python 3.12+因distutils移除导致pip报错的问题——核心思想是：明确区分python/python3/pip/pip3的指向关系，始终以不破坏系统稳定性为前提，用正确机制而非暴力符号链接来管理多版本共存。

直接装 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 输出，比盲目升级重要得多。

文中关于的知识介绍，希望对你的学习有所帮助！若是受益匪浅，那就动动鼠标收藏这篇《Linux下安装与升级Python3全攻略》文章吧，也可关注golang学习网公众号了解相关技术文章。