随着 Python 生态系统的不断发展，pyproject.toml 逐渐成为 Python 项目的标准化配置方式，取代了传统的 setup.py。它提供了一种更简洁、灵活且可扩展的方式来管理项目元数据、依赖关系和构建过程。本文将详细介绍如何将现有的 Python 项目迁移到 pyproject.toml，并重点讲解 uv 工具的使用。

什么是 uv？

uv 是一个用于创建和管理 Python 项目的命令行工具。它可以帮助你快速初始化一个新的项目，并自动生成 pyproject.toml 文件。此外，uv 还提供了许多其他的功能，例如添加依赖、构建项目、发布项目等。

为什么迁移到 pyproject.toml？

• 标准化： pyproject.toml 是 PEP 518 定义的标准化配置格式，越来越多的 Python 工具和框架开始支持它。
• 简洁： 相比于 setup.py，pyproject.toml 的语法更加简洁直观，易于阅读和编写。
• 灵活： pyproject.toml 支持自定义构建系统，可以更好地满足不同项目的个性化需求。
• 可扩展： pyproject.toml 可以通过插件机制进行扩展，以支持更多的功能。

迁移步骤

1. 安装 uv：

   pip install uv
   

2. 初始化项目：
   在你的项目根目录下运行以下命令：

   uv init --project .
   

   这将在你的项目中创建一个 pyproject.toml 文件，并根据项目结构自动填充一些基本信息。
3. 添加依赖：
   如果你已经有 requirements.txt 文件，可以使用以下命令将依赖添加到 pyproject.toml 中：

   uv add -r requirements.txt
   

   uv 会自动解析 requirements.txt 文件，并将其中的依赖添加到 pyproject.toml 的 dependencies 部分。
   如果没有，使用 uv add 命令添加依赖即可。

pyproject.toml 文件详解

pyproject.toml 文件包含了项目的各种配置信息，主要包括：

• 项目元数据： 包括项目名称、版本、作者、描述等。
• 依赖关系： 指定项目所依赖的第三方库。
• 构建配置： 配置项目的构建方式，例如指定构建工具、生成哪些文件等。
• 其他配置： 可以自定义一些其他配置，例如测试配置、文档生成配置等。