Repolode
rust-lang

rust-lang/rust-clippy

Rust 代码检查工具,内置 800 多条 lint 规则,用于发现常见错误并改写为更地道的写法。

Star
13,625
Fork
2,238
未关闭 Issue
2,889
最近提交
3小时前

这是什么?

Clippy 是 Rust 的代码检查工具,用于发现常见错误、低效写法以及不够地道的代码风格。它内置 800 多条 lint 规则,按 correctness、suspicious、style、complexity、perf、pedantic、restriction 等类别组织,每个类别有默认的告警级别,可按需调整严格程度。

通过 rustup 安装组件后,可以用 `cargo clippy` 以 cargo 子命令运行。部分问题可以用 `cargo clippy --fix` 自动修复。不使用 cargo 的项目可以用 `clippy-driver` 并传入与 rustc 相同的参数运行,也可以接入 CI,让警告或错误导致构建失败。

项目可以通过 `clippy.toml` 文件做个性化配置,例如设置最低支持的 Rust 版本(MSRV),或禁止某些变量名。lint 级别也可以在代码中用 allow、warn、deny 属性设置,或通过命令行参数全局指定。

核心功能

  • 01内置 800 多条 lint,覆盖正确性、代码风格、复杂度和性能等方面
  • 02部分 lint 支持通过 `cargo clippy --fix` 自动修复
  • 03可通过 clippy.toml 进行项目级配置,包括最低支持版本(MSRV)
  • 04既可作为 cargo 子命令运行,也可通过 clippy-driver 独立使用
  • 05可按类别调整 lint 级别,支持代码内设置或命令行参数

适用场景

  • 在开发过程中发现 Rust 项目中的常见错误和低效写法
  • 在 CI 中执行 lint 检查,使警告导致构建失败
  • 团队统一代码风格,约定共享的 lint 配置
  • 在要求更严格的代码库中限制特定写法,如 unwrap 或 todo!

快速上手

  1. 1

    从 rustup.rs 安装 Rustup

  2. 2

    添加 Clippy 组件

    rustup component add clippy
  3. 3

    在 Cargo 项目中运行 Clippy

    cargo clippy

使用前须知

  • Clippy 是针对 Rust 代码的 linter,因此仅适用于 Rust 项目。

收录于专题

标签

常见问题

rust-clippy 是什么?
Rust 代码检查工具,内置 800 多条 lint 规则,用于发现常见错误并改写为更地道的写法。 Clippy 是 Rust 的代码检查工具,用于发现常见错误、低效写法以及不够地道的代码风格。它内置 800 多条 lint 规则,按 correctness、suspicious、style、complexity、perf、pedantic、restriction 等类别组织,每个类别有默认的告警级别,可按需调整严格程度。
rust-clippy 可以免费使用吗?用的什么许可证?
rust-clippy 以 Apache-2.0 许可证开源。用于商业产品前,请先确认许可证条款。
rust-clippy 还在维护吗?
活跃维护中。rust-clippy 最近一次提交是在 2026年11月6日。
rust-clippy 适合用来做什么?
在开发过程中发现 Rust 项目中的常见错误和低效写法 在 CI 中执行 lint 检查,使警告导致构建失败 团队统一代码风格,约定共享的 lint 配置 在要求更严格的代码库中限制特定写法,如 unwrap 或 todo!
rust-clippy 怎么安装和运行?
从 rustup.rs 安装 Rustup 添加 Clippy 组件: rustup component add clippy 在 Cargo 项目中运行 Clippy: cargo clippy
在哪里获取 rust-clippy?
源代码和安装说明在 GitHub 上:https://github.com/rust-lang/rust-clippy

概要由 AI 根据项目 README 生成;GitHub 数据每日更新。

相关项目