创建源代码发行版

可以在项目根文件夹中执行以下命令来创建项目的源代码发行版：

$ python -m build --sdist .

这将在项目根文件夹的 dist 文件夹中创建一个 .tar.gz 存档。该存档包含版本控制中最新提交的完整内容，并删除所有版本控制元数据。未提交的修改和版本控制系统未知的文件不包含在内。

源代码发行版存档是通过将必要的元数据文件添加到通过执行 meson dist --no-tests --allow-dirty 命令获得的存档中创建的。为了生成源代码发行版，meson-python 必须通过运行 meson setup 命令成功配置 Meson 项目。可以将额外的参数传递给 meson dist 来更改其行为。有关详细信息，请参考相关的Meson 文档以及将参数传递给 Meson指南。

meson dist 命令使用底层版本控制系统的归档工具来创建存档。这意味着只能为版本控制系统中的项目创建源代码发行版。Meson 支持 Git 和 Mercurial 版本控制系统。

可以通过版本控制系统提供的相关机制将文件从源代码发行版中排除。当使用 Git 作为版本控制系统时，可以通过设置 export-ignore 属性将文件从源代码发行版中排除。例如，添加一个包含以下内容的 .gitattributes 文件：

dev/** export-ignore

将导致 dev 文件夹从源代码发行版中排除。有关详细信息，请参考 git archive 文档。dist 脚本提供了另一种更改源代码发行版内容的机制。有关详细信息，请参考相关的Meson 文档。