03-Cargo 参考 on 编程那些事儿

02-工作空间

Thu, 30 Jul 2026 14:49:00 +0800

译文 · 基于 The Cargo Book

工作空间

原文链接: https://doc.rust-lang.org/cargo/reference/workspaces.html

工作空间（workspace） 是一个或多个包的集合，这些包称为 工作空间成员（workspace members），被一起管理。

05-配置文件（Profiles）

Thu, 30 Jul 2026 14:49:00 +0800

译文 · 基于 The Cargo Book

配置文件（Profiles）

原文链接: https://doc.rust-lang.org/cargo/reference/profiles.html

配置文件（Profiles）提供了一种改变编译器设置的方式，影响优化与调试符号等内容。

Cargo 有 4 个内置配置文件：dev、release、test 与 bench。若命令行上未指定配置文件，则根据正在运行的命令自动选择。除内置配置文件外，也可以指定自定义的用户定义配置文件。

06-配置

Thu, 30 Jul 2026 14:49:00 +0800

译文 · 基于 The Cargo Book

配置

原文链接: https://doc.rust-lang.org/cargo/reference/config.html

本文档说明 Cargo 的配置系统如何工作，以及可用的键与配置项。关于通过清单（manifest）对包（package）进行配置，请参阅清单格式。

07-环境变量

Thu, 30 Jul 2026 14:49:00 +0800

译文 · 基于 The Cargo Book

环境变量

原文链接: https://doc.rust-lang.org/cargo/reference/environment-variables.html

Cargo 会设置并读取若干环境变量，你的代码可以检测或覆盖它们。以下按 Cargo 与之交互的时机，列出 Cargo 设置的环境变量：

Cargo 读取的环境变量

你可以覆盖这些环境变量，以改变 Cargo 在你系统上的行为：

09-构建缓存

Thu, 30 Jul 2026 14:49:00 +0800

译文 · 基于 The Cargo Book

构建缓存

原文链接: https://doc.rust-lang.org/cargo/reference/build-cache.html

Cargo 将构建输出存放到「target」与「build」目录中。默认情况下，这两个目录都指向你的 工作空间 根目录下名为 target 的目录。要更改 target-dir 的位置，可以设置 CARGO_TARGET_DIR [环境变量]、build.target-dir 配置值，或 --target-dir 命令行标志。要更改 build-dir 的位置，可以设置 CARGO_BUILD_BUILD_DIR [环境变量] 或 build.build-dir 配置值。

10-包 ID 规范

Thu, 30 Jul 2026 14:49:00 +0800

译文 · 基于 The Cargo Book

包 ID 规范

原文链接: https://doc.rust-lang.org/cargo/reference/pkgid-spec.html

包 ID 规范

Cargo 的子命令经常需要在依赖图中引用某个特定包，以执行更新、清理、构建等操作。为解决此问题，Cargo 支持 包 ID 规范（Package ID Specifications）。规范是一个字符串，用于在包图中唯一地引用某一个包。

11-外部工具

Thu, 30 Jul 2026 14:49:00 +0800

译文 · 基于 The Cargo Book

外部工具

原文链接: https://doc.rust-lang.org/cargo/reference/external-tools.html

Cargo 的目标之一是与第三方工具（如 IDE 与其他构建系统）简单集成。为便于集成，Cargo 提供若干设施：

cargo metadata 命令，以 JSON 输出包结构与依赖信息，

13-SemVer 兼容性

Thu, 30 Jul 2026 14:49:00 +0800

译文 · 基于 The Cargo Book

SemVer 兼容性

原文链接: https://doc.rust-lang.org/cargo/reference/semver.html

本章详细说明对于包的新发布，按惯例什么被视为兼容或破坏性的 SemVer 变更。关于 SemVer 是什么，以及 Cargo 如何用它来确保库的兼容性，见 SemVer 兼容性一节。

14-未来不兼容报告

Thu, 30 Jul 2026 14:49:00 +0800

译文 · 基于 The Cargo Book

未来不兼容报告

原文链接: https://doc.rust-lang.org/cargo/reference/future-incompat-report.html

Cargo 会检查所有依赖中的未来不兼容（future-incompatible）警告。这些警告针对可能在将来变成硬错误的变更，届时依赖将无法在未来版本的 rustc 中构建。若发现任何警告，会显示一小段提示，说明已发现警告，并提供如何显示完整报告的说明。

15-报告构建耗时

Thu, 30 Jul 2026 14:49:00 +0800

译文 · 基于 The Cargo Book

报告构建耗时

原文链接: https://doc.rust-lang.org/cargo/reference/timings.html

--timings 选项可给出各次编译耗时的信息，并跟踪随时间变化的并发信息。

1

cargo build --timings

这会在 target/cargo-timings/cargo-timing.html 写入一份 HTML 报告。同时也会在同一目录写入一份文件名带时间戳的报告副本，以便查看较旧的运行结果。

16-Lint

Thu, 30 Jul 2026 14:49:00 +0800

译文 · 基于 The Cargo Book

Lint

原文链接: https://doc.rust-lang.org/cargo/reference/lints.html

说明

本章介绍由 cargo 自身发出的 lint。

关于为 rustc 或 clippy 等工具配置 lint 级别，见 Manifest 格式章节中的 lints 小节。

警告

Cargo 的 lint 系统尚不稳定，只能在 nightly 工具链上使用。

17-不稳定特性

Thu, 30 Jul 2026 14:49:00 +0800

译文 · 基于 The Cargo Book

不稳定特性

原文链接: https://doc.rust-lang.org/cargo/reference/unstable.html

实验性的 Cargo 特性只在 nightly 渠道上可用。我们鼓励你试用这些特性，看看它们是否满足你的需求，以及是否存在问题或缺陷。更多关于某个特性的信息，请查看下面列出的跟踪 issue 链接；如果你希望获得后续更新，可以点击 GitHub 上的 subscribe 按钮。