用途:为 HASH 仓库的 Rust 工作区提供 Cargo.toml 依赖管理规范,适用于添加、更新或移除依赖,以及整理依赖分区、配置特性等场景。
主要能力与规则:外部依赖统一加到工作区根 [workspace.dependencies],使用插入符版本(如 version = "1.0.0" 即 ^1.0.0),除确有需要外设置 default-features = false;包内 Cargo.toml 通过 workspace = true 引用,暴露在公有 API 的依赖加 public = true。包内依赖按四段组织并保留注释标题:公有工作区依赖、公有第三方依赖、私有工作区依赖、私有第三方依赖,即使某段为空也保留注释;依赖名用空格对齐。禁止在包 Cargo.toml 直接写版本号,禁止在工作区根使用 = 前缀的精确版本,避免无意启用默认特性,不要混排依赖类型。
使用方式:先检查工作区根是否已有该依赖,没有则按上述版本与特性规则加入;再判断应放入哪一段,在包内以 workspace = true(必要时加 public = true)引用。可选依赖用 optional = true 并在 [features] 中以 dep: 形式声明。
限制:资料仅覆盖 HASH 工作区约定,未提供其他项目适用性、工具版本要求或自动化校验方式。