用途:把 Cargo 当作带版本管理的包管理器、构建编排器和自动化接口,用于配置、运行、诊断和自动化 Rust 包与工作区。决策依据项目实际的 Cargo 版本、MSRV、工作区根、目标、特性与发布模型,以官方 Cargo Book 为权威。
主要能力:按任务路由到对应参考,包括官方文档地图、命令地图、工作流、清单与目标、依赖/特性/解析器、工作区、配置与环境、profile、构建脚本、构建缓存与诊断、交叉编译、注册表与认证、打包与发布、元数据与自动化、不稳定特性。
使用方式:先做预检,运行 rustc --version --verbose、cargo --version、cargo locate-project --workspace、cargo metadata --no-deps --format-version 1,确认根清单是包还是虚拟工作区、edition、rust-version、resolver、锁文件策略、选中的包/目标/特性/profile/目标三元组、依赖来源与离线约束,以及所需行为在当前 Cargo 版本上是否稳定。核心流程为:定位根、声明兼容性、检查有效状态、做最小改动、显式选择矩阵、先诊断再优化、验证产物与副作用。
验证示例:cargo metadata --format-version 1、cargo fmt --all --check、cargo check --workspace --all-targets --all-features、cargo test --workspace --all-targets --all-features、cargo clippy --workspace --all-targets --all-features -- -D warnings、cargo package --list;仓库提交或要求锁文件时追加 --locked。
适用场景:Rust 包与工作区的构建、测试、文档、CI、依赖与特性管理、发布与打包、交叉编译、构建脚本与缓存诊断。
限制:不涉及 crate 选择与供应链策略、工作区拓扑、测试架构、rustdoc 内容、rustfmt/Clippy 策略、运行时性能、API 兼容性、嵌入式运行时等,这些属于其他技能边界。优先稳定行为;推荐 nightly 前须指明具体不稳定特性、调用形式、跟踪 issue、回退方案与移除条件。该技能不收集、存储或传输用户数据,注册表令牌、Git 凭据、环境变量、生成产物与包内容应视为敏感信息。