Clippy 是什么
Clippy 是 Rust 官方提供的 lint 工具，作为工具链组件安装后随 cargo 运行，提供数百条 lint 并按正确性、风格、复杂度、性能等分组。correctness 组默认是 deny（不修就编译失败），其余多为 warn；可以用命令行开关或源码属性调整级别，也能按具体 lint 名精确豁免。
基本信息
| 安装 | rustup component add clippy |
|---|---|
| 运行方式 | cargo clippy（在项目目录内） |
| 常见分组 | correctness / style / complexity / perf |
| 级别开关 | -D 提升为错误、-W 警告、-A 允许 |
| 门禁写法 | cargo clippy -- -D warnings |
典型使用场景
- 提交前扫一遍性能与惯用法问题，如不必要的克隆、可简化的匹配
- CI 中把警告升级为错误，作为合并门禁
- 评审前统一跑一遍，减少风格往返
- 学习 Rust 惯用法：lint 说明通常附带推荐写法
- 升级工具链后检查新引入的 lint 与既有豁免是否还成立
常用命令
常用命令
cargo clippy --all-targets --all-features # 覆盖所有目标与特性组合
cargo clippy -- -D warnings # 把警告当错误，用于 CI 门禁
cargo clippy --fix --allow-dirty # 自动修复可修复项（先提交或备份）
rustup component add clippy # 确认组件已安装
cargo clippy -- -A clippy::too_many_arguments # 命令行临时豁免，正式豁免写在源码里接入 CI 时把关键分组提升为 deny：cargo clippy -- -D warnings 是常见门禁写法。历史代码告警太多时，可先只对变更文件生效，再逐步扩大范围。
常见分组读法
| 分组 | 含义 | 处理顺序 |
|---|---|---|
| correctness | 明确的错误写法，默认拒绝 | 必须处理，通常改完即编译通过 |
| perf | 可能影响性能的写法 | 结合热点判断，收益明显时优先改 |
| style | 惯用法与可读性 | 可批量处理，或交给自动修复 |
| complexity | 结构过于复杂的写法 | 结合可读性判断，别为过检查拆散逻辑 |
常见 lint 与含义
- 不必要的克隆：能借用的地方却取了所有权
- 可以用迭代器改写的显式循环
- match 分支可以用更简短的模式表达
- 函数参数过多，建议封装成一个结构体传入
- 可合并的条件判断与可简化的返回写法
cargo clippy --fix 会直接改写工作区文件：运行前先提交或备份，否则自动修复与手工改动混在一起，出问题时难以回退。
自动修复不等于可以直接提交：--fix 只处理标记为可机器修复的 lint，改完仍要跑测试与格式化，并在提交信息里说明涉及哪些文件。