Skip to content
SPECIFICTION
Get listed

Clippy

doc.rust-lang.org

WindowsmacOSLinux
Visit doc.rust-lang.org
Spec score 7.6 #23 of 33 in Linters

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

Alternatives to ClippyAll alternatives →