说到在 Ubuntu 上安装 Python,很多用户都会被“需要哪些依赖”这个问题弄得一头雾水。其实把安装方式拆分来看,常见的无非是三种:通过系统包管理器 APT 安装、从源码编译安装,或者借助 pyenv 管理多个 Python 版本。不同安装场景对应的依赖项略有区别,下面按方式逐一说明,方便你快速判断 Ubuntu 安装 Python 需要准备什么。

APT 安装场景
如果你只是想尽快在 Ubuntu 上使用系统自带的 Python 版本,那么通过 APT 安装是最简单、最稳妥的方法。系统会自动处理大部分底层依赖,你只需要安装几个常用软件包即可。不同 Ubuntu 发行版本中,包名可能会带有不同的数字后缀,但整体功能基本一致——记住下面这些核心依赖就足够了:
- 核心运行与包管理:
python3、python3-pip - 开发与编译:
python3-dev、build-essential - 虚拟环境:
python3-venv
实际安装时,一条命令就可以完成:
sudo apt update
sudo apt install python3 python3-pip python3-dev python3-venv build-essential
这组依赖基本覆盖了大多数 Ubuntu Python 开发、测试和部署场景,也是最适合新手的 Python 安装方案。
从源码编译安装场景
如果你想安装特定版本的 Python,或者希望自定义编译参数(例如启用性能优化),那么就需要选择源码编译安装。在 Ubuntu 上编译 Python 时,最常见的问题就是编译过程中提示缺少某个库文件。因此,更推荐提前一次性安装完整依赖,这样可以避免中途报错。下面这些依赖覆盖了 SSL 加密、压缩归档、数据库支持、字符编码以及 Tk 图形界面等常见模块需求:
- 基础工具链:
build-essential、gcc、make - SSL/加密:
libssl-dev、libffi-dev、python-openssl - 压缩与归档:
zlib1g-dev、libbz2-dev、liblzma-dev - 数据库与解析:
libsqlite3-dev、libreadline-dev、libncurses5-dev、libncursesw5-dev - GUI/Tk:
tk-dev - 其他常用:
libgdbm-dev、libdb-dev、libpcap-dev、xz-utils、libexpat1-dev、libc6-dev
依赖安装完成后,后续编译流程并不复杂:先下载 Python 源码,再执行 ./configure --enable-optimizations(开启优化编译),然后使用 make -j $(nproc) 进行并行编译,最后运行 sudo make altinstall。这里特别要注意使用 altinstall 而不是 install,这样可以避免覆盖 Ubuntu 系统默认的 python3。只要按照这份依赖清单准备,通常就不会因为缺少库而导致安装失败。
使用 pyenv 管理多版本时的依赖
如果你需要在一台 Ubuntu 机器上同时维护多个 Python 版本,比如不同项目分别依赖不同的 Python 3.x 小版本,那么 pyenv 会是非常高效的选择。由于 pyenv 本质上也是在用户环境中编译并安装各个 Python 版本,因此它所需的编译依赖,与前面源码安装所需内容基本一致。除此之外,再补充一些常用辅助工具,使用体验会更好:
- 构建与压缩:
build-essential、libssl-dev、zlib1g-dev、libbz2-dev、libreadline-dev、libsqlite3-dev、libffi-dev、liblzma-dev、xz-utils - 可选增强:
llvm、wget、curl、git
安装 pyenv 本身只需要一条命令:curl https://pyenv.run | bash。安装完成后,记得把相关配置写入 shell 配置文件中,例如 ~/.bashrc 或 ~/.zshrc:
export PYENV_ROOT="$HOME/.pyenv"
export PATH="$PYENV_ROOT/bin:$PATH"
eval "$(pyenv init --path)"
eval "$(pyenv init -)"
只要提前把这些 Python 编译依赖安装完整,后续使用 pyenv 安装任何版本时,通常都能更加顺利,也能减少常见报错。
安装后验证与常用后续步骤
无论你选择的是 APT、源码编译,还是 pyenv 安装 Python,完成后的第一步都应该是验证环境是否已经正确安装:
python3 --version
pip3 --version
如果能够正常输出版本号,说明 Ubuntu 上的 Python 与 pip 环境已经可用。接下来更推荐的做法是立即创建虚拟环境,用于隔离项目依赖:python3 -m venv venv && source venv/bin/activate,然后再在虚拟环境中执行 pip install -r requirements.txt 安装项目所需的软件包。这样做可以有效避免不同项目之间的依赖冲突,也能防止污染系统级 Python 环境。对于长期进行 Python 开发或部署的用户来说,这是非常值得养成的标准习惯。
