Sdist

Definition / 释义

sdist（常见于 Python 生态）指“源代码发行包”（source distribution）：一种把项目源代码按约定格式打包发布的归档文件（常见如 .tar.gz），用于分发源码，供用户在本地构建与安装。另有与之对应的二进制发行包 wheel。

Pronunciation / 发音

/ˈɛs.dɪst/

Examples / 例句

I built an sdist for my library before uploading it.
我在上传之前为我的库构建了一个 sdist 源码包。

If the project includes compiled extensions, installing from sdist may require a compiler and the right build dependencies.
如果项目包含需要编译的扩展，从 sdist 安装可能需要编译器以及正确的构建依赖。

Etymology / 词源

sdist 是 source distribution（源代码发行包）的缩写；在 Python 打包工具（如 setuptools）中作为命令名/产物名广泛使用，用来区别于 bdist/wheel 这类偏“已构建好的二进制分发”。

Related Words / 相关词

• Wheel
• Setuptools
• Pip
• Build
• Distribution
• Pyproject
• PEP517
• Tarball

Literary Works / 作品举例

• Python Packaging User Guide（packaging.python.org）中关于 “Source Distributions (sdist)” 的章节
• setuptools Documentation（Setuptools 用户指南）中关于 python -m build / setup.py sdist 的说明
• PEP 517（A build-system independent format for source trees）中涉及 sdist 构建接口与流程的描述
• PEP 518（Specifying Minimum Build System Requirements for Python Projects）中与构建 sdist 所需依赖相关的内容