Rust / 系统课时
检查依赖与安全
检查依赖与安全
本课建立一套可重复执行的 Rust 依赖检查流程:先看清实际依赖树与重复版本,再用策略文件约束许可证和来源,最后扫描已知安全公告,并把结果转化为可处理的工程任务。
学习目标
- 使用
cargo tree定位直接依赖、传递依赖和重复版本 - 使用
cargo-deny检查许可证、禁用项、来源与安全公告 - 区分必须修复、需要评估和可以暂时接受的问题
先看清实际依赖图
检查应以 Cargo.lock 解析出的实际版本为准,而不能只阅读 Cargo.toml。cargo tree 展示依赖图,-d 只显示存在多个版本的 crate,-i 则反向追踪“谁引入了它”。Cargo 官方文档也建议用重复版本视图定位旧依赖链。:contentReference[oaicite:0]{index=0}
在工作区根目录执行:
cargo tree
cargo tree -d
cargo tree -i <CRATE>预期结果:
cargo tree -> 输出完整依赖树
cargo tree -d -> 输出重复版本及其反向依赖链;没有重复版本时可能无正文输出
cargo tree -i -> 输出所有依赖 <CRATE> 的路径<CRATE> 替换为实际包名。发现重复版本后,不要直接删除 Cargo.lock;应先查看上游 crate 是否可升级、是否能统一版本要求,或是否由不必要的 feature 引入。
配置统一的依赖策略
cargo-deny 可以把许可证白名单、重复版本、禁用依赖、注册表来源和公告检查集中到 deny.toml。许可证检查依据项目配置评估每个 crate 的许可证表达式,bans 检查则可发现多版本和被禁止的 crate。:contentReference[oaicite:1]{index=1}
先安装工具并生成配置:
cargo install cargo-deny --locked
cargo deny init预期结果:
Installed package `cargo-deny v<VERSION>`
Created <PATH>/deny.toml实际版本和路径可能不同。将生成的配置收敛为团队明确接受的规则,例如:
[advisories]
ignore = []
[licenses]
allow = ["MIT", "Apache-2.0", "BSD-3-Clause", "ISC"]
confidence-threshold = 0.8
[bans]
multiple-versions = "warn"
wildcards = "deny"
[sources]
unknown-registry = "deny"
unknown-git = "deny"
allow-registry = ["https://github.com/rust-lang/crates.io-index"]
allow-git = []这份配置是起点,不是通用答案。许可证白名单必须与项目发布方式和组织合规要求一致;确需例外时,应限定到具体 crate,并记录原因,而不是扩大整个白名单。
执行许可证与安全检查
运行完整策略检查,再用 cargo-audit 对 Cargo.lock 执行一次独立的 RustSec 扫描。cargo audit 的职责是发现 RustSec Advisory Database 中已登记的依赖风险。:contentReference[oaicite:2]{index=2}
cargo deny check bans licenses advisories sources
cargo install cargo-audit --locked
cargo audit预期结果:
cargo deny check -> 各检查项通过,进程退出码为 0
cargo audit -> 未发现公告命中时报告扫描完成,进程退出码为 0若命中公告,优先升级直接依赖并重新生成锁文件;若风险来自传递依赖,用 cargo tree -i <CRATE> 找到上游入口。只有确认受影响代码路径未被使用、暂时没有可升级版本并且已有补偿措施时,才可带原因临时忽略公告。
形成可执行的处理顺序
检查结果按风险处理比“看到告警就全部升级”更可靠:
- 已知安全漏洞或来源不可信:阻止合并,立即升级、替换或移除。
- 许可证不符合发布要求:停止发布,交由项目负责人或合规人员确认。
- 重复版本:评估编译时间、二进制体积和维护成本,再决定统一或记录例外。
- 未维护公告:确认是否存在替代 crate,并评估迁移成本和暴露面。
在持续集成中,应固定工具安装方式并提交 deny.toml。检查失败必须保留完整诊断,便于从 crate、版本和引入路径直接定位责任依赖。
本课总结
cargo tree -d与cargo tree -i分别回答“哪些版本重复”和“谁引入了它”cargo-deny负责团队策略,cargo-audit负责已知安全公告扫描- 例外必须限定范围、说明原因并设置后续清理条件
下一课预告
下一课将从实现细节转向命令行工具设计,先明确输入、输出、子命令、退出码和异常边界,再开始编码。