17370845950

在 Linux 上安装 Python 时，新手常会遇到各种问题。这些问题大多与系统依赖、环境配置和权限管理有关。只要按步骤排查，通常都能顺利解决。

命令无法识别

输入 python 或 pip 命令时，提示 “command not found”，这是最常见的入门问题。

• 系统可能默认安装的是 python3 和 pip3，尝试使用这两个命令替代
• 通过包管理器安装：Ubuntu/Debian 系统运行 sudo apt install python3 python3-pip；CentOS/RHEL 系统先确保 EPEL 源已安装，再运行 sudo yum install python3 python3-pip
• 如果想用简短命令，可创建软链接：sudo ln -s /usr/bin/python3 /usr/bin/python 和 sudo ln -s /usr/bin/pip3 /usr/bin/pip

模块或库安装失败

使用 pip 安装第三方库时出现编译错误，特别是像 lxml、cryptography 这类包含 C 扩展的库。

• 根本原因是缺少编译工具和开发头文件。需要安装系统级依赖
• Ubuntu/Debian 系统执行：sudo apt install build-essential python3-dev libssl-dev libffi-dev libxml2-dev libxslt1-dev zlib1g-dev
• CentOS/RHEL 系统执行：sudo yum install gcc gcc-c++ python3-devel openssl-devel libffi-devel libxml2-devel libxslt-devel
• 安装完依赖后，重新运行 pip install 命令

SSL 模块不可用

安装包时报错 “Certificate verify failed” 或找不到 SSL 模块，这通常发生在源码编译安装时。

• 系统缺少 OpenSSL 开发库。先安装它：Ubuntu/Debian 执行 sudo apt install libssl-dev，CentOS/RHEL 执行 sudo yum install openssl-devel
• 如果是自己编译 Python，在 ./configure 前要确保上述库已装好，编译过程才能正确链接 SSL 支持
• 对于较新版本的 Python，可能还需要指定 OpenSSL 的路径进行编译

多版本共存混乱

系统同时存在多个 Python 版本，导致 pip 安装的库无法被正确的 Python 解释器找到。

• 不要轻易修改系统自带的 Python 链接，以免影响系统工具（如 yum）
• 明确区分使用哪个版本，直接调用全名，如 python3.11 和 pip3.11
• 最佳实践是使用虚拟环境隔离项目依赖，通过 python -m venv myenv 创建，激活后所有操作都在独立环境中进行