clang-tidy

Run checks on file

$ clang-tidy [file.cpp] -- -I[include/path]

$ clang-tidy --list-checks

$ clang-tidy --list-checks -checks='*'

$ clang-tidy -checks='-*,modernize-*' [file.cpp]

$ clang-tidy --fix [file.cpp]

$ clang-tidy --export-fixes=[fixes.yaml] [file.cpp]

$ clang-tidy --dump-config

clang-tidy [options] file [-- compileoptions_]

clang-tidy is a clang-based C++ linter tool for diagnosing and fixing typical programming errors including style violations, interface misuse, and bugs detectable via static analysis. It is part of the LLVM/Clang extra tools.
The tool provides hundreds of checks organized into categories such as bugprone, modernize, performance, readability, and cppcoreguidelines. Many checks can automatically apply fixes to source code, making it useful for large-scale code modernization (e.g., migrating to modern C++ idioms).
clang-tidy uses a .clang-tidy configuration file for project-level settings and supports inline suppression with NOLINT comments. For large projects, run-clang-tidy.py provides parallel execution across multiple files.

-checks=list

Comma-separated list of checks (+/- prefixed globs)

List enabled checks

Apply suggested fixes

Apply fixes even if errors occur

Write fixes to YAML file

Dump configuration to stdout

Treat specified warnings as errors

Path to compilation database

Path to .clang-tidy config

Create .clang-tidy in project root:

$ Checks: '-*,modernize-*,bugprone-*'
WarningsAsErrors: '*'

bugprone-*

Bug-prone patterns

C++ modernization

Performance issues

Code readability

C++ Core Guidelines

Use comments: NOLINT, NOLINTNEXTLINE, NOLINTBEGIN/NOLINTEND

Requires compilation database for complex projects. Use run-clang-tidy.py for parallel execution.

clang(1), clang-format(1)