28.1. distutils — 构建和安装 Python 模块 ¶

distutils 包在 Python 安装中提供构建和安装额外模块的支持。新模块可能是 100% 纯 Python，也可能是以 C 编写的扩展模块，或可能是 Python 包的集合 (包括以 Python 和 C 编码的模块)。

大多数 Python 用户 not 想直接使用此模块，而是使用由 Python Packaging Authority (Python 打包管理局) 所维护的跨版本工具。尤其， setuptools 增强替代 distutils 提供：

• 支持声明工程依赖
• 用于配置要包括在源发行中的文件的额外机制 (包括用于集成版本控制系统的插件)
• 声明工程入口点的能力，可用作应用程序插件系统的基础
• 在安装时自动生成 Windows 命令行可执行文件，而不是需要预构建它们的能力
• 跨所有支持 Python 版本行为一致

推荐 pip 安装程序运行所有 setup.py 脚本采用 setuptools ，即使脚本本身只导入 distutils 。参考 Python 打包用户指南 了解更多信息。

为让打包工具作者和用户更深入理解当前打包的细节及分发系统，基于传统 distutils 的用户文档编制和 API 参考仍然可用：

• 安装 Python 模块 (旧版)
• 分发 Python 模块 (旧版)

上一话题

28. 软件打包和分发

下一话题

28.2. ensurepip — 自引导 pip 安装程序