跳到主要内容

1 / 4概念

Toolchain: Cargo and Quality Gates

Cargo 同时是包管理器、构建系统和 workspace 协调器。判断标准不是“能不能编译通过”,而是能否解释依赖解析结果、feature 统一来源和构建产物差异,并用固定门禁保证每次构建可复现。

1 概念​

1.1 一句话定义​

Cargo 读取 Cargo.toml,按语义化版本解析依赖并写入 Cargo.lock,把 package 拆成 crate 目标后调用 rustc 编译、链接。feature 是加性的编译期开关,profile 决定优化与符号,fmt、clippy、test、audit 构成质量门。

1.2 它解决什么问题​

  • 依赖版本漂移导致“本机能跑、CI 失败”。
  • feature 被传递依赖意外开启,改变行为与体积。
  • 构建脚本、链接器和目标平台差异难以复现。
  • 格式、静态检查、测试与漏洞审计缺少统一入口。

Cargo 把解析、编译与门禁收敛到一个命令;代价是 feature 统一和构建缓存会制造隐式耦合。

1.3 不属于本页的内容​

主题去哪
所有权、trait、async 与 unsafeRust Language 各页
CI 平台与流水线编排CI/CD
镜像仓库与制品分发Private Registry
链接器、虚拟内存与进程Memory Management、Processes & Threads
文档站点构建Docs & Knowledge Management

1.4 关键术语​

术语含义容易混淆的点
package一个 Cargo.toml 定义的包可含多个 crate 目标
crate编译单元不是文件
targetlib、bin、test、bench、example每个目标单独编译
workspace多个 package 的共享构建根不是发布单元
feature加性的编译期开关不是可选 API 的替代品
lockfile精确版本与校验和二进制项目应提交
registry包索引与下载源不是镜像缓存
semver主次修订版本契约0.x 规则不同
MSRV最低支持的 Rust 版本用 rust-version 声明
profile优化、调试、panic 策略不是 feature
build script构建前执行的 Rust 程序可产生副作用
proc macro编译期展开的宏属于依赖图