Advanced Clippy 是一个用于配置 Rust Clippy 静态检查的技能,目标是对 Rust 项目进行更全面、更严格的 lint 管理。
用途:提供一套可参考的高级 Clippy 配置方案,覆盖项目级配置、工作区级配置、自定义规则、lint 分类启用与抑制,以及 CI 和 IDE 集成,适合希望在代码质量上采用渐进式严格策略的 Rust 团队。
主要能力:
- 支持创建 clippy.toml 或 .clippy.toml,配置认知复杂度阈值、类型复杂度阈值、函数长度阈值、参数数量阈值、Vec 堆分配阈值、数组大小阈值等。
- 支持 disallowed-methods 与 disallowed-types,可禁用特定方法或类型并附带自定义原因说明,例如禁用 unwrap、expect、process::exit、println! 等。
- 支持选择 Clippy 的 lint 分类:all、pedantic、restriction、nursery、cargo、complexity、correctness、perf、style、suspicious。
- 支持在 Cargo.toml 中使用 [workspace.lints.clippy] 和 [workspace.lints.rust] 设置工作区级 lint 级别,便于所有 crate 继承。
- 支持函数级、模块级和内联的 allow/deny/warn 属性覆盖。
- 提供 GitHub Actions、Reviewdog、pre-commit 钩子和 rust-analyzer 的集成示例。
- 提供禁用命名、允许标识符、导入粒度、分号一致性等风格配置项示例。
使用方式:
- 通过 rustup 安装 Clippy:rustup component add clippy,并用 cargo clippy --version 验证。
- 使用 cargo clippy 运行检查,可配合 --all-targets、--all-features、--workspace 等参数。
- 使用 -- -D warnings 将警告视为错误,或在 CI 中结合 -W clippy::pedantic、-W clippy::nursery、-D clippy::correctness 等参数。
- 在项目根目录创建 clippy.toml 配置项目级规则;在 Cargo.toml 中配置工作区级 lint 级别。
- 在 rust-analyzer 中设置 check.command 为 clippy,并配置 extraArgs 实现保存时检查。
适用场景:
- Rust 项目需要统一代码规范、减少潜在缺陷和性能问题。
- 团队希望按“先默认、后严格”的方式逐步启用 lint。
- 在 CI 中执行严格检查,或在代码评审中通过 Reviewdog 展示 Clippy 结果。
- 需要在 IDE 中获得实时 Clippy 反馈。
限制:
- 资料未提供独立的收费、价格或平台支持信息。
- 部分 lint 分类(如 nursery)可能产生误报,需要按项目情况调整。
- 启用过多严格 lint 可能产生大量警告,建议从 correctness 开始逐步增加。
- 资料未提供具体的版本兼容范围或完整 lint 列表,仅给出常见配置示例。