CentOS 上安装 Python 的关键注意事项
一 系统兼容性与版本选择
在 CentOS 上部署 Python，第一步就得处理好“新旧共存”的问题。一个核心原则是：千万别动系统自带的 Python 2.7。尤其是在 CentOS 7 上，yum 等核心系统工具深度依赖它。正确的做法是让新增的 Python 3 与系统版本并行安装，调用时使用明确的命令，比如 python3 或 pip3。
选择版本时，需要在项目需求与系统仓库支持之间做好权衡。举个例子，CentOS 7 的默认仓库通常只提供到 Python 3.6。如果你的项目需要用到 3.8、3.9 乃至 3.11 的新特性，那么从源码编译或者使用 pyenv 这类多版本管理工具，就成了更现实的选择。
当多个版本共存时，务必避免直接使用不带版本号的 python 命令。优先使用带版本号的二进制文件，或者通过 alternatives、pyenv 等工具进行清晰、可控的版本切换。
二 安装方式与路径管理
安装方式主要有三种，各有优劣：
- yum/dnf 安装：最省心、最稳定，但版本往往受限；
- 源码编译：可控性最高，适合安装新版本或进行定制化配置；
- pyenv：在用户态管理多个版本，能彻底避免污染系统环境。
如果选择源码编译，有几个要点需要特别注意：
- 安装编译依赖：这是一切的基础。通常需要安装 gcc、make、openssl-devel、zlib-devel、bzip2-devel、readline-devel、sqlite-devel、libffi-devel、ncurses-devel、gdbm-devel、tk-devel、xz-devel 等一系列开发包。
- 配置与安装：配置时，像
--enable-optimizations、--enable-shared、--with-system-ffi、--with-ensurepip=install都是常用选项。编译时可以使用make -j $(nproc)来充分利用多核性能。最关键的一步是，安装务必使用make altinstall，这能确保不会覆盖系统的/usr/bin/python。 - 处理共享库：如果启用了
--enable-shared，编译后需要确保动态库能被系统找到。通常的做法是将/usr/local/lib路径添加到/etc/ld.so.conf.d/python3.x.conf文件中，然后执行ldconfig命令。
关于路径与软链接：如果自定义了安装前缀（比如 /usr/local），别忘了将 /usr/local/bin 加入用户的 PATH 环境变量。如果需要提供全局的 python3 或 pip3 命令，可以通过创建软链接或者使用 alternatives 工具进行版本切换，切忌直接修改 /usr/bin/python。
三 多版本共存与系统工具保护
多版本共存的核心，是保护好系统工具的可用性。在 CentOS 7 上，/usr/bin/yum 和 /usr/libexec/urlgrabber-ext-down 等脚本的首行，通常明确指向 /usr/bin/python2.7。如果不慎修改了默认的 python 指向，yum 就会因为语法不兼容而彻底罢工。一旦发生这种情况，必须将其恢复为 python2.7。
那么，如何安全地切换版本呢？推荐两种方式：
- 使用
alternatives工具来管理/usr/bin/python3的默认指向； - 或者在用户的 shell 环境配置文件（如
.bashrc）中设置别名（例如alias python=python3），这种改动仅对当前用户生效，不会影响系统级别的脚本。
四 虚拟环境与依赖管理
为了项目的纯净与隔离，始终优先使用虚拟环境。在项目目录下，执行 python3.x -m venv .venv && source .venv/bin/activate，就能创建一个独立的 Python 环境，有效避免不同项目间的包冲突。
安装依赖时，要使用与当前解释器匹配的 pip（例如 pip3.9），并用 requirements.txt 文件来管理依赖清单：
- 升级 pip：
pip3.9 install --upgrade pip - 国内镜像加速：
pip3.9 config set global.index-url https://mirrors.aliyun.com/pypi/simple/ - 批量安装：
pip3.9 install -r requirements.txt
五 常见坑与快速排错
最后，盘点几个高频出现的“坑”及其解决方案：
- 编译时报错 ModuleNotFoundError: No module named ‘_ctypes’：这通常是缺少
libffi-devel开发包导致的。安装它并重新编译即可。 - 启用
--enable-shared后，运行程序找不到共享库：检查/usr/local/lib是否已正确添加到ld.so.conf.d下的配置文件中，并确认已执行ldconfig命令。 - 误改系统 python 导致 yum 无法使用：将
/usr/bin/python的软链接恢复指向/usr/bin/python2.7，或者使用alternatives工具进行修正。 - 编译或 pip 安装速度极慢：考虑更换 PyPI 镜像源，优化网络环境。对于国内用户，使用阿里云等国内镜像加速是立竿见影的办法。
- 脚本调用了错误的 Python 版本：在脚本的首行使用正确的 shebang（例如
#!/usr/bin/env python3），并在执行前通过which python3命令确认解释器的实际路径。
