02-构建命令 on 编程那些事儿

01-cargo bench

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

译文 · 基于 The Cargo Book

cargo-bench(1)

原文链接: https://doc.rust-lang.org/cargo/commands/cargo-bench.html

名称

cargo-bench — 执行包的基准测试

大纲

cargo bench [options] [benchname] [-- bench-options]

描述

编译并执行基准测试。

基准测试过滤参数 benchname 以及两个短划线（--）之后的所有参数都会传给基准测试二进制，进而传给 libtest（rustc 内置的单元测试与微基准测试框架）。若同时向 Cargo 与二进制传参，则 -- 之后的参数传给二进制，之前的传给 Cargo。关于 libtest 参数的详情，请参见 cargo bench -- --help 的输出，以及 rustc 手册中关于测试工作原理的章节： https://doc.rust-lang.org/rustc/tests/index.html。

02-cargo build

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

译文 · 基于 The Cargo Book

cargo-build(1)

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

名称

cargo-build — 编译当前包

大纲

cargo build [options]

描述

编译本地包及其所有依赖。

选项

包选择

默认情况下，若未给出包选择选项，所选包取决于所选清单文件（若未给出 --manifest-path，则基于当前工作目录）。若清单是工作空间根，则选择该工作空间的默认成员；否则仅选择清单所定义的包。

03-cargo check

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

译文 · 基于 The Cargo Book

cargo-check(1)

原文链接: https://doc.rust-lang.org/cargo/commands/cargo-check.html

名称

cargo-check — 检查当前包

大纲

cargo check [options]

描述

检查本地包及其所有依赖是否有错误。这实质上会编译这些包，但不执行最终的代码生成步骤，因此比运行 cargo build 更快。编译器会将元数据文件保存到磁盘，以便在源文件未修改时后续运行可复用它们。某些诊断与错误仅在代码生成期间发出，因此本质上不会被 cargo check 报告。

04-cargo clean

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

译文 · 基于 The Cargo Book

cargo-clean(1)

原文链接: https://doc.rust-lang.org/cargo/commands/cargo-clean.html

名称

cargo-clean — 移除已生成的产物

大纲

cargo clean [options]

描述

移除 target 目录中 Cargo 过去生成的产物。

若不带任何选项，cargo clean 将删除整个 target 目录。

选项

包选择

未选择任何包时，将清理工作空间中的所有包及其所有依赖。

05-cargo clippy

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

译文 · 基于 The Cargo Book

cargo-clippy(1)

原文链接: https://doc.rust-lang.org/cargo/commands/cargo-clippy.html

名称

cargo-clippy — 检查包以捕获常见错误并改进 Rust 代码

描述

这是随 Rust 工具链分发的可选组件中的外部命令。它并非内置于 Cargo，可能需要额外安装。

06-cargo doc

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

译文 · 基于 The Cargo Book

cargo-doc(1)

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

名称

cargo-doc — 构建包的文档

大纲

cargo doc [options]

描述

为本地包及所有依赖构建文档。输出以 rustdoc 的常规格式放在 target/doc。

注意： 文档生成是累积的：target 目录中已有的文档文件在不同的 cargo doc 调用之间会保留。若要移除已生成的文档，请对 cargo-clean(1) 传入 --doc。

07-cargo fetch

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

译文 · 基于 The Cargo Book

cargo-fetch(1)

原文链接: https://doc.rust-lang.org/cargo/commands/cargo-fetch.html

名称

cargo-fetch — 从网络获取包的依赖

大纲

cargo fetch [options]

描述

若存在 Cargo.lock 文件，此命令将确保所有 git 依赖和/或注册表依赖均已下载并可在本地使用。在 cargo fetch 之后，除非锁文件发生变化，后续 Cargo 命令可离线运行。

08-cargo fix

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

译文 · 基于 The Cargo Book

cargo-fix(1)

原文链接: https://doc.rust-lang.org/cargo/commands/cargo-fix.html

名称

cargo-fix — 自动修复 rustc 报告的 lint 警告

大纲

cargo fix [options]

描述

此 Cargo 子命令会自动获取 rustc 诊断（如警告）中的建议，并将其应用到你的源代码。其目的是帮助自动化那些 rustc 本身已经知道如何告诉你去修复的任务！

09-cargo fmt

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

译文 · 基于 The Cargo Book

cargo-fmt(1)

原文链接: https://doc.rust-lang.org/cargo/commands/cargo-fmt.html

名称

cargo-fmt — 使用 rustfmt 格式化当前 crate 的所有 bin 与 lib 文件

描述

这是随 Rust 工具链分发的可选组件中的外部命令。它并非内置于 Cargo，可能需要额外安装。

10-cargo miri

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

译文 · 基于 The Cargo Book

cargo-miri(1)

原文链接: https://doc.rust-lang.org/cargo/commands/cargo-miri.html

名称

cargo-miri — 在 Miri 中运行二进制 crate 与测试

描述

这是随 Rust 工具链分发的可选组件中的外部命令。它并非内置于 Cargo，可能需要额外安装。

此命令仅在 nightly 通道可用。

11-cargo run

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

译文 · 基于 The Cargo Book

cargo-run(1)

原文链接: https://doc.rust-lang.org/cargo/commands/cargo-run.html

名称

cargo-run — 运行当前包

大纲

cargo run [options] [-- args]

描述

运行本地包的二进制目标或示例。

两个短划线（--）之后的所有参数都会传给要运行的二进制程序。若同时向 Cargo 与二进制程序传参，则 -- 之后的参数传给二进制，之前的传给 Cargo。

12-cargo rustc

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

译文 · 基于 The Cargo Book

cargo-rustc(1)

原文链接: https://doc.rust-lang.org/cargo/commands/cargo-rustc.html

名称

cargo-rustc — 编译当前包，并向编译器传递额外选项

大纲

cargo rustc [options] [-- args]

描述

将编译当前包（或由 -p 指定的包）的指定目标及其所有依赖。指定的 args 都会传给最终的编译器调用，而不会传给任何依赖。注意：编译器仍会无条件地收到诸如 -L、--extern 和 --crate-type 等参数，指定的 args 只是追加到编译器调用中。

13-cargo rustdoc

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

译文 · 基于 The Cargo Book

cargo-rustdoc(1)

原文链接: https://doc.rust-lang.org/cargo/commands/cargo-rustdoc.html

名称

cargo-rustdoc — 使用指定的自定义标志构建包的文档

大纲

cargo rustdoc [options] [-- args]

描述

将为当前包（或由 -p 指定的包）的指定目标生成文档，并把指定的 args 传给最终的 rustdoc 调用。此命令不会为依赖生成文档。注意：rustdoc 仍会无条件地收到诸如 -L、--extern 和 --crate-type 等参数，指定的 args 只是追加到 rustdoc 调用中。

14-cargo test

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

译文 · 基于 The Cargo Book

cargo-test(1)

原文链接: https://doc.rust-lang.org/cargo/commands/cargo-test.html

名称

cargo-test — 执行包的单元测试与集成测试

大纲

cargo test [options] [testname] [-- test-options]

描述

编译并执行单元测试、集成测试与文档测试。

测试过滤参数 TESTNAME 以及两个短划线（--）之后的所有参数都会传给测试二进制，进而传给 libtest（rustc 内置的单元测试与微基准测试框架）。若同时向 Cargo 与二进制传参，则 -- 之后的参数传给二进制，之前的传给 Cargo。关于 libtest 参数的详情，请参见 cargo test -- --help 的输出，以及 rustc 手册中关于测试工作原理的章节：https://doc.rust-lang.org/rustc/tests/index.html。