python-build-standalone: 创建高度便携的 Python 分发版

python-build-standalone: 创建高度便携的 Python 分发版

Overview

python-build-standalone 生成自包含、高度便携的 Python 分发版，其中包含完整功能的 Python 安装。通过确保标准库的大多数扩展模块存在且库依赖要么静态链接要么捆绑，该项目将运行时依赖降至最低，以确保该分发版在目标架构的任何系统上都能运行。

Core Technical Approach

为了实现高便携性，python-build-standalone 采用了几种特定的构建策略：

  • 最小化运行时依赖： 构建过程限制了运行时所需的共享库集合。
  • CPU 指令约束： 该项目限制所使用的 CPU 指令，以确保在同一架构下更广泛的硬件范围内兼容。
  • 灵活重新打包： 一些分发版包含构建产物（目标文件和库）以及丰富的元数据。这使得下游重新打包者可以创建自定义分发版，例如删除 SQLite 或 OpenSSL 以减小二进制大小，以便在较大的应用程序中嵌入。

Ecosystem Integration and Maintenance

最初由 indygreg 开发，该项目目前由 Astral（以及由 OpenAI 扩展）维护。它为若干知名的 Python 工具提供了基础设施：

  • uv： 由 Astral 提供的 Python 包和项目管理器使用这些分发版为用户安装 Python 版本。
  • 其他工具： 诸如 pipx、Hatch、Poetry 和 Bazel 等工具也使用这些分发版来提供自动化的 Python 安装。

根据 Astral 的 Charlie Marsh 所述，当前的工程工作重点放在三个主要方面：跟上上游 CPython 的步伐，解决相对于 CPython 的已知“怪癖”，以及优化这些分发版的性能以匹配或超过其他 CPython 构建。

Related Projects and Alternatives

PyOxidizer 和 PyOxy

对于需要单文件可执行文件的用户，姐妹项目 PyOxy（以及更广泛的 PyOxidizer 项目）利用 python-build-standalone 分发版。PyOxy 添加 Rust 代码以增强解释器的功能，使开发者能够：

  • 生成代表 Python 应用程序的单文件可执行文件。
  • 将自包含的 Python 解释器作为库嵌入到较大的应用程序中。
  • 在 Rust 和 Python 之间创建桥梁，使得可以将 Rust 添加到 Python 或反之亦然。

Cosmopolitan

对于极端跨平台需求的替代方案是 APE/Cosmopolitan 项目，该项目提供了能够在 Linux、macOS、Windows、FreeBSD、OpenBSD 和 NetBSD 上原生运行的二进制文件，这些文件来自单个二进制文件（大约 40MB 的 Python）。

Implementation Considerations and Limitations

虽然这些分发版是“自包含”的，但它们并不完全独立于宿主环境。技术限制包括：

  • 系统边界： 分发版仍然面临 glibc 版本和 CPU 特性级别的限制。
  • 原生扩展： 虽然 musl 构建移除了 libc 依赖，但它们无法加载标准的 .so 扩展。
  • 行为怪癖： 用户可能会遇到特定的怪癖，例如 Windows 上缺少 pip.exe，Linux 上使用 libedit，或在 Python REPL 中特殊键的问题。

"虚拟环境仍然依赖于宿主解释器和操作系统。这些分发版固定了解释器、标准库和大多数运行时依赖，但剩余的边界是生产惊喜发生的地方：glibc 版本、CPU 特性级别和第三方原生扩展。"

Summary of Distribution Types

Archive Type Contents Primary Use Case
完整归档 完整的构建产物和元数据 下游重新打包和自定义嵌入
仅安装归档 可直接运行的 Python 安装 直接执行和基于工具的安装（例如通过 uv）

Sources