### 使用 `pyproject.toml` 替代 `setup.py` 在不使用 `setup.py` 的情况下打包 Python 项目，推荐采用现代的打包标准，即通过 `pyproject.toml` 文件定义构建系统和依赖项。该文件是 PEP 517 和 PEP 518 引入的标准配置方式，支持更简洁、清晰的项目结构。 一个基本的 `pyproject.toml` 文件如下所示： ```toml [build-system] requires = ["setuptools>=61.0", "wheel"] build-backend = "setuptools.build_meta" [project] name = "my_package" version = "0.1.0" description = "A sample Python project" authors = [ { name="Example Author", email="author@example.com" } ] dependencies = [ "requests>=2.25.1", "numpy>=1.21.0" ] classifiers = [ "Programming Language :: Python :: 3", "License :: OSI Approved :: MIT License", "Operating System :: OS Independent", ] ``` 在项目根目录下创建上述文件后，可以使用以下命令生成源码包和 wheel 包： ```bash python -m build ``` 这将生成与 `python setup.py sdist bdist_wheel` 类似的结果，但不再需要 `setup.py` 文件[^4]。 ### 使用 `flit` 简化模块打包 对于仅包含单个模块的小型项目，可使用 `flit` 工具进行打包。它无需编写复杂的配置文件即可完成分发包的构建。安装并使用 `flit` 的示例如下： ```bash pip install flit flit init flit build ``` 执行 `flit init` 将引导用户创建 `pyproject.toml` 文件，并自动填充基本信息。之后运行 `flit build` 即可生成 `.whl` 和 `.tar.gz` 分发包。 ### 使用 `poetry` 管理依赖与打包 另一种流行的方式是使用 `poetry`，它不仅支持打包，还提供依赖管理功能。首先确保已安装 `poetry`，然后初始化项目并构建分发包： ```bash poetry new my_project cd my_project poetry build ``` `poetry` 自动生成 `pyproject.toml` 并管理项目的元数据和依赖关系。构建完成后，`dist/` 目录中将包含所有必要的分发文件。 ### 使用 `hatch` 构建与打包 `hatch` 是一个轻量级的 Python 项目构建工具，同样基于 `pyproject.toml`。它提供了快速构建、测试和发布的能力。安装并使用 `hatch` 的方法如下： ```bash pip install hatch hatch new my_project cd my_project hatch build ``` 该工具自动生成项目结构，并通过内置命令完成打包流程。 ### 打包静态资源文件 若项目中包含非 Python 文件（如配置文件、图片等），需在 `pyproject.toml` 中指定这些文件的包含规则。例如，在 `setuptools` 配置中添加 `package-data` 或 `include-package-data` 字段来控制哪些文件应被打包进最终的发行版中： ```toml [project] ... include-package-data = true [tool.setuptools.package-data] my_package = ["*.txt", "*.json"] ``` 此外，也可以通过 `MANIFEST.in` 文件指定额外的非代码资源文件打包规则，尽管这种方式在某些场景下可能不如 `package-data` 可靠[^5]。 ---