Ubuntu From Scratch如何安装Python

Ubuntu From Scratch 安装 Python 实操指南

一 准备环境

万事开头先打基础。在开始编译之前，得确保系统环境已经准备妥当。

• 更新索引并安装基础工具与编译链：
  • sudo apt update && sudo apt upgrade -y
  • sudo apt install -y build-essential checkinstall wget curl git
• 安装编译 Python 所需依赖库： 这一步是关键，依赖装全了，后续编译才能一路绿灯。下面的清单已经做了精简，但覆盖了常见模块以及SSL、压缩、数据库等核心需求。
  • sudo apt install -y libssl-dev zlib1g-dev libbz2-dev libreadline-dev libsqlite3-dev libncurses5-dev libgdbm-dev liblzma-dev libffi-dev uuid-dev libc6-dev
• 简单来说，安装这些开发包，是为了确保编译后的Python能正常使用 _ssl、_bz2、readline、sqlite3、ffi、lzma、gdbm、ncurses、uuid 这些标准库模块，从而避免后续使用pip或编译第三方包时出现令人头疼的失败。

二 从源码编译安装 Python

基础打好，接下来就是核心的编译安装环节了。从源码安装，能给你最大的控制权和灵活性。

• 选择版本并下载源码： 这里以长期支持且稳定的 Python 3.10.12 为例，当然你也可以替换成 3.11.x 等其他稳定版本。
  • cd /usr/src
  • sudo wget https://www.python.org/ftp/python/3.10.12/Python-3.10.12.tgz
  • sudo tar xzf Python-3.10.12.tgz && cd Python-3.10.12
• 配置构建： 配置选项决定了Python的“出厂设置”。推荐启用优化并确保pip随装。
  • ./configure --enable-optimizations --with-ensurepip=install
  • 这里有个小提示：--enable-optimizations 选项会进行PGO（性能引导优化）和LTO（链接时优化），能让Python运行得更快，但首次构建时间会显著加长。而 --with-ensurepip=install 则能确保安装完成后，pip工具已经就位，省去后续单独安装的麻烦。
• 编译与安装： 这是最考验耐心的阶段。使用并行编译可以充分利用多核CPU，大大加速过程。
  • make -j $(nproc)
  • sudo make altinstall （注意，这里用的是 altinstall，非常重要！）
  • 安装完成后，可执行文件通常位于 /usr/local/bin 目录下，名字会是 python3.10 和 pip3.10 这样的版本化形式。
• 验证安装结果： 最后一步，确认一切工作正常。
  • python3.10 --version
  • python3.10 -m pip --version
• 如果磁盘空间紧张或者希望尽快完成构建，可以去掉 --enable-optimizations 选项，这样构建时间会大幅缩短，只是运行时性能会略有降低，需要做个权衡。

三 设置默认版本与便捷使用

Python装好了，怎么用起来最顺手？这里有几个策略。

• 使用 alternatives 切换系统默认 python3： 这是推荐的做法，安全且可控。
  • sudo update-alternatives --install /usr/bin/python3 python3 /usr/bin/python3.10 100
  • 如果系统里安装了多个Python 3版本，可以通过 sudo update-alternatives --config python3 命令进行交互式切换。
• 直接使用版本化命令： 这是最稳妥的方式，完全避免了误操作影响系统默认解释器的风险。
  • 直接调用 python3.10、pip3.10 即可。
• 将 /usr/local/bin 加入 PATH： 在“From Scratch”这类最小化安装环境中，/usr/local/bin 目录可能不在默认的PATH搜索路径前列。
  • echo 'export PATH=/usr/local/bin:$PATH' >> ~/.bashrc && source ~/.bashrc
  • 执行这步操作，可以确保系统能直接找到我们刚安装的Python，避免出现“command not found”的错误。

四 创建虚拟环境与验证 pip

现代Python开发离不开虚拟环境。它能将不同项目的依赖完全隔离开，保持系统环境的整洁。

• 安装并使用 venv 隔离项目依赖：
  • sudo apt install -y python3.10-venv
  • python3.10 -m venv ~/venvs/myapp （创建一个名为myapp的虚拟环境）
  • source ~/venvs/myapp/bin/activate （激活虚拟环境）
  • python -m pip install --upgrade pip （在虚拟环境中升级pip到最新版）
• 在虚拟环境中验证： 激活后，命令行提示符通常会变化。此时可以确认Python和pip都指向了虚拟环境内的版本。
  • python -V
  • pip -V
• 工作完成后，使用 deactivate 命令即可退出当前虚拟环境。

五 常见问题与排查要点

即便按照指南操作，偶尔也可能遇到小波折。这里列出几个常见坑点，帮你快速排雷。

• 缺少依赖导致配置/编译失败：
  • 这是最常见的问题。典型的缺失依赖包括 libffi-dev、libssl-dev、zlib1g-dev、libbz2-dev、libreadline-dev、libsqlite3-dev、liblzma-dev 等。根据配置或编译时的具体报错信息，使用apt安装对应的“-dev”开发包，然后重新执行配置和编译步骤即可。
• 覆盖系统 Python 的风险：
  • 务必警惕！绝对不要使用 make install，而应始终使用 make altinstall。如果确实需要更改系统默认的 python3 命令指向，优先使用上文介绍的 update-alternatives 工具来管理，这样更安全、可逆。
• 构建时间过长：
  • 如果首次配置时启用了 --enable-optimizations，构建时间可能会非常长（尤其是在性能一般的机器上）。如果时间紧迫，可以去掉此选项重新配置编译，能显著加快速度。性能优化可以留待以后有需要时再进行。
• pip 不存在或版本异常：
  • 确保在配置步骤使用了 --with-ensurepip=install 选项。如果安装后发现pip有问题，可以尝试在已安装的解释器上执行 python3.10 -m ensurepip --upgrade 来修复或升级pip。