Clippy
doc.rust-lang.org
Spec sheet
- Purpose
- Clippy is a collection of lints that catches common mistakes and improves Rust code.Read 9 Oct 2026 · doc.rust-lang.org
- Support
- The Clippy contribution guide directs people with questions to GitHub issues or the #t-clippy Zulip stream.Read 9 Oct 2026 · github.com
- License
- The Clippy repository is licensed under either Apache License 2.0 or MIT, at the licensee's option.Read 9 Oct 2026 · github.com
- Automatic fixes
- `cargo clippy --fix` can automatically apply some lint suggestions and implies `--all-targets`.Read 9 Oct 2026 · doc.rust-lang.org
- CI use
- Clippy's documentation recommends running it in CI with warnings treated as errors.Read 9 Oct 2026 · doc.rust-lang.org
- Configurable levels
- Users can change lint levels by category, and the default lint group includes correctness, suspicious, style, complexity, and performance lints.Read 8 Oct 2026 · doc.rust-lang.org
- Configuration
- Lint levels can be changed on the command line or in source code, and Clippy supports configuration through `clippy.toml`.Read 9 Oct 2026 · doc.rust-lang.org
- Continuous integration
- The documentation recommends running Clippy in CI with warnings treated as errors and using Clippy from the same toolchain as the project compiler.Read 8 Oct 2026 · doc.rust-lang.org
- False positives
- The pedantic lint group is described as strict and as allowing occasional false positives.Read 9 Oct 2026 · doc.rust-lang.org
- GitHub Actions
- The documentation says GitHub-hosted runners with the latest stable Rust have Clippy preinstalled.Read 9 Oct 2026 · doc.rust-lang.org
- How to run
- Clippy runs as the `cargo clippy` subcommand or directly through `clippy-driver`.Read 9 Oct 2026 · doc.rust-lang.org
- Installation
- Clippy is usually included with rustup toolchains and can be added with `rustup component add clippy`; the minimal profile does not install it automatically.Read 9 Oct 2026 · doc.rust-lang.org
- Lint categories
- Lint groups include correctness, suspicious, style, complexity, performance, pedantic, restriction, nursery, and Cargo.Read 9 Oct 2026 · doc.rust-lang.org
- Lint configuration
- Some lint settings can be configured in clippy.toml or .clippy.toml, and the documentation says this configuration file is unstable and may be deprecated.Read 8 Oct 2026 · doc.rust-lang.org
- Lint count
- The lint list contains 837 lints.Read 9 Oct 2026 · rust-lang.github.io
- Notable limitation
- The documentation warns that restriction lints may flag reasonable code, lack an alternative suggestion, or contradict other lints, and advises against enabling the whole category.Read 9 Oct 2026 · doc.rust-lang.org
- Restriction limits
- The documentation advises against enabling the entire restriction lint category because its lints may flag reasonable code, lack alternatives, or conflict with other lints.Read 8 Oct 2026 · doc.rust-lang.org
- Rust version support
- Projects can configure a minimum supported Rust version so Clippy can adjust or suppress lints involving newer language features.Read 8 Oct 2026 · doc.rust-lang.org
- Suggestion confidence
- Clippy suggestions carry applicability information because some suggestions may be incorrect and need human supervision.Read 8 Oct 2026 · doc.rust-lang.org
- Ways to run
- Clippy can run as a Cargo subcommand or directly through the clippy-driver binary.Read 8 Oct 2026 · doc.rust-lang.org
- Workspace support
- Clippy supports Cargo workspace options, including selecting a package and using --no-deps.Read 8 Oct 2026 · doc.rust-lang.org
Where Specifiction places it
- Linters#23 of 337.6