本文档描述了 uv 的模块化 Rust crate 架构，解释了各个子 crate 如何协同工作以提供 Python 包管理功能。它涵盖了主应用程序结构、命令行界面组织以及核心子系统之间的交互模式。
有关依赖解析等特定子系统的信息，请参阅 依赖解析。有关命令行界面结构详情，请参阅 命令结构。
uv 构建为一个 Rust 工作区，包含众多专用 crate，每个 crate 负责 Python 包管理的特定方面。这种模块化设计促进了代码重用、清晰的关注点分离和可维护性。
来源：crates/uv/Cargo.toml16-61 Cargo.lock1-3
crate 架构分为几个逻辑类别
| 类别 | Crates | 目的 |
|---|---|---|
| 主应用程序 | uv | 主二进制入口点和命令编排 |
| CLI 层 | uv-cli, uv-dispatch | 命令行界面和执行上下文 |
| 核心逻辑 | uv-resolver, uv-installer, uv-client, uv-distribution | 主要包管理操作 |
| Python 管理 | uv-python, uv-virtualenv | Python 解释器发现和虚拟环境处理 |
| 基础设施 | uv-cache, uv-settings, uv-fs | 跨领域关注点和共享实用程序 |
| 标准 | pep508-rs, pep440-rs, uv-normalize | Python 包标准实现 |
| 构建系统 | uv-build, uv-install-wheel, uv-extract | 包构建和安装 |
CLI 系统围绕着一个分层的命令组织结构，该结构映射到 Python 包管理的各个功能领域。
来源：crates/uv-cli/src/lib.rs77-95 crates/uv-cli/src/lib.rs366-516
命令分发系统通过多个层级处理用户输入
来源：crates/uv/src/lib.rs60-185 crates/uv-cli/src/lib.rs77-95
uv 使用一个多层配置系统，结合命令行参数、环境变量和配置文件来解析每次操作的最终设置。
来源：crates/uv/src/settings.rs56-138 crates/uv/src/settings.rs155-198
配置系统按照特定的优先级顺序发现和加载多个来源的设置
--config-file）uv.toml, pyproject.toml）来源：crates/uv/src/lib.rs122-156
主应用程序协调整个执行流程，从命令解析到最终结果输出。
主应用程序协调了几个关键组件
| 组件 | 类型 | 目的 |
|---|---|---|
Cli | struct | 主命令行界面结构 |
命令 | 枚举 | 所有可用的 uv 命令 |
GlobalSettings | struct | 影响所有操作的全局配置 |
CacheSettings | struct | 缓存配置和管理 |
Printer | 枚举 | 输出格式化和详细程度控制 |
ExitStatus | 枚举 | 命令执行结果指示 |
来源：crates/uv-cli/src/lib.rs77-95 crates/uv/src/settings.rs56-72
该架构通过明确定义的接口和共享数据结构，使不同的子系统能够协同工作。
几个 crate 提供了跨多个子系统使用的共享基础设施
uv-fs：带有原子写和错误处理的文件系统操作uv-cache：用于包、元数据和构建工件的全局缓存系统uv-settings：配置管理和设置解析uv-static：静态数据和环境变量定义uv-normalize：包名称的规范化和标准化来源：crates/uv/Cargo.toml16-61 crates/uv-static/src/env_vars.rs1-73
这种模块化架构使 uv 能够维护清晰的关注点分离，同时实现子系统之间的有效数据流。每个 crate 都可以独立开发、测试和维护，同时为包管理器的整体功能做出贡献。