static analysis of C/C++ code
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
Oliver Stöneberg d6eb3a8f40
some changes for clang/clang-tidy 15 (#4310)
2 weeks ago
.github/workflows ci: remove macos-10.15 job, it has been deprecated 3 weeks ago
addons donate-cpu: greatly improved `LibraryIncludes.get_libraries()` performance / some optimizations and cleanups (#4273) 4 weeks ago
cfg gnu.cfg: Added support for error_at_line() 4 weeks ago
cli reduced padding in some classes/structs (#4295) 3 weeks ago
cmake some changes for clang/clang-tidy 15 (#4310) 2 weeks ago
cve-test-suite fixed/excluded some shellcheck warnings and actually fail the build when something is found (#3068) 2 years ago
democlient Remove bug hunting. This feature will be provided in Cppcheck premium. 4 months ago
externals replaced `if(MATCHES)` with `if(STREQUAL)` (#4263) 1 month ago
gui mitigated most clang-tidy warnings in headers (#4175) 2 weeks ago
htmlreport fix html report generation with pygments >= 2.12.0 (#4110) 3 months ago
lib some changes for clang/clang-tidy 15 (#4310) 2 weeks ago
man fix: fixed broken link in manpage (#4302) 3 weeks ago
oss-fuzz fail `run-clang-tidy` in case of compiler warnings / fixed Clang warnings / cleanups (#4036) 3 months ago
platforms Running astyle [ci skip] 2 years ago
rules Activated 'make validateRules' and improved rule XML file parsing. Now, it optionally accepts '<rules>...</rules>' tags to make xmllint happy. 2 months ago
samples samples; Fixed missing return in non-void functions 1 year ago
snap Fix permissions of certain non-executable files (#1083) 5 years ago
test Add test for #11061 (#4307) 2 weeks ago
tools donate-cpu: some cleanups (#4291) 3 weeks ago
valgrind Add Valgrind CI action (#2921) 2 years ago
win_installer fixed Cppcheck version (#4292) 3 weeks ago
.clang-tidy some changes for clang/clang-tidy 15 (#4310) 2 weeks ago
.codacy.yml Codacy: Try to exclude all addon test files 4 years ago
.gitignore fixed some clang-tidy warnings (#3080) 3 months ago
.mailmap Revert "Revert "Add a .mailmap file."" 9 years ago
.selfcheck_unused_suppressions added unusedFunction self check to CI / cleanups (#3526) 7 months ago
.travis.yml Moved some stuff from Travis to GitHub Actions / Cleanups (#3715) 2 months ago
.travis_llvmcheck_suppressions Travis: updated the .travis_llvmcheck_suppressions file, * is not allowed 4 years ago
.travis_suppressions enabled functionConst and functionStatic in selfcheck (#3862) 5 months ago
.uncrustify.cfg Format with uncrustify (#3388) 1 year ago
AUTHORS Added 'Alon Alexander' to AUTHORS file because of it's contribution with ea3bb8b297 2 months ago
CMakeLists.txt avoid unnecessary `validateCFG-*` targets in CMake (#4166) 2 months ago
Makefile Fix crash on Windows with -j option (#4229) 4 weeks ago
benchmarks.txt benchmarks: Added CImg. Removed old stuff. 3 years ago
build-pcre.txt Add how to install pcre by using homebrew (#3087) 2 years ago
cppcheck-errors.rng Readd cppcheck-errors.rng 1 year ago
cppcheck.cppcheck Add cppcheck.cppcheck build dir 5 years ago
cppcheck.sln Updated to Visual Studio 2019 3 years ago
createrelease fixed Cppcheck version (#4292) 3 weeks ago
doxyfile Fix typos (#1568) 4 years ago
generate_coverage_report rename externals/tinyxml to externals/tinyxml2 2 years ago
naming.json Check for JSON error when parsing addon .json files + fixes (#2374) 3 years ago bumped minimum supported GCC version to 4.8 (#3768) 6 months ago
pylintrc_travis pylintrc_travis: Add check for bad-indentation, fix issues in (#2349) 3 years ago Removed Travis badge as well 6 months ago
readme.txt Remove bug hunting. This feature will be provided in Cppcheck premium. 4 months ago added MinGW to CI and fixed local MinGW build (#3826) 6 months ago
releasenotes.txt Mentioned changes from LCppC in release notes: 9eb16e1002. 2 months ago
requirements.txt Install pcre from github since the site is no longer available (#3546) 9 months ago
runformat runformat: simple build instruction 1 year ago fixed/excluded some shellcheck warnings and actually fail the build when something is found (#3068) 2 years ago


GitHub Actions OSS-Fuzz Coverity Scan Build Status License
Github Action Status OSS-Fuzz Coverity Scan Build Status License

About the name

The original name of this program was "C++check", but it was later changed to "Cppcheck".

Despite the name, Cppcheck is designed for both C and C++.


A manual is available online.

Donate CPU

Cppcheck is a hobby project with limited resources. You can help us by donating CPU (1 core or as many as you like). It is simple:

  1. Download (and extract) Cppcheck source code.
  2. Run script: python cppcheck/tools/

The script will analyse debian source code and upload the results to a cppcheck server. We need these results both to improve Cppcheck and to detect regressions.

You can stop the script whenever you like with Ctrl C.


Any C++11 compiler should work. For compilers with partial C++11 support it may work. If your compiler has the C++11 features that are available in Visual Studio 2013 / GCC 4.8 then it will work.

To build the GUI, you need Qt.

When building the command line tool, PCRE is optional. It is used if you build with rules.

There are multiple compilation choices:

  • qmake - cross platform build tool
  • cmake - cross platform build tool
  • Windows: Visual Studio (VS 2013 and above)
  • Windows: Qt Creator + mingw
  • gnu make
  • g++ 4.8 (or later)
  • clang++


Example, compiling Cppcheck with cmake:

mkdir build
cd build
cmake ..
cmake --build .

If you want to compile the GUI you can use the flag. -DBUILD_GUI=ON

For rules support (requires pcre) use the flag. -DHAVE_RULES=ON

For release builds it is recommended that you use: -DUSE_MATCHCOMPILER=ON

Using cmake you can generate project files for Visual Studio,XCode,etc.


You can use the gui/ file to build the GUI.

cd gui

Visual Studio

Use the cppcheck.sln file. The file is configured for Visual Studio 2019, but the platform toolset can be changed easily to older or newer versions. The solution contains platform targets for both x86 and x64.

To compile with rules, select "Release-PCRE" or "Debug-PCRE" configuration. pcre.lib (pcre64.lib for x64 builds) and pcre.h are expected to be in /externals then. A current version of PCRE for Visual Studio can be obtained using vcpkg.

Visual Studio (from command line)

If you do not wish to use the Visual Studio IDE, you can compile cppcheck from the command line the following command.

msbuild cppcheck.sln

VS Code (on Windows)

Install MSYS2 to get GNU toolchain with g++ and gdb ( Create a settings.json file in the .vscode folder with the following content (adjust path as necessary):

    "": "C:\\msys64\\usr\\bin\\bash.exe",
    "": [
    "": {
        "CHERE_INVOKING": "1",
        "MSYSTEM": "MINGW64",

Run "make" in the terminal to build cppcheck.

For debugging create a launch.json file in the .vscode folder with the following content, which covers configuration for debugging cppcheck and

    // Use IntelliSense to learn about possible attributes.
    // Hover to view descriptions of existing attributes.
    // For more information, visit:
    "version": "0.2.0",
    "configurations": [
            "name": "cppcheck",
            "type": "cppdbg",
            "request": "launch",
            "program": "${workspaceFolder}/cppcheck.exe",
            "args": [
            "stopAtEntry": false,
            "cwd": "${workspaceFolder}",
            "environment": [],
            "externalConsole": true,
            "MIMode": "gdb",
            "miDebuggerPath": "C:/msys64/mingw64/bin/gdb.exe",
            "setupCommands": [
                    "description": "Enable pretty-printing for gdb",
                    "text": "-enable-pretty-printing",
                    "ignoreFailures": true
            "name": "",
            "type": "python",
            "request": "launch",
            "program": "${workspaceFolder}/addons/",
            "console": "integratedTerminal",
            "args": [

Qt Creator + MinGW

The PCRE dll is needed to build the CLI. It can be downloaded here:

GNU make

Simple, unoptimized build (no dependencies):


The recommended release build is:

make MATCHCOMPILER=yes FILESDIR=/usr/share/cppcheck HAVE_RULES=yes CXXFLAGS="-O2 -DNDEBUG -Wall -Wno-sign-compare -Wno-unused-function"


  1. MATCHCOMPILER=yes Python is used to optimise cppcheck. The Token::Match patterns are converted into C++ code at compile time.

  2. FILESDIR=/usr/share/cppcheck Specify folder where cppcheck files are installed (addons, cfg, platform)

  3. HAVE_RULES=yes Enable rules (PCRE is required if this is used)

  4. CXXFLAGS="-O2 -DNDEBUG -Wall -Wno-sign-compare -Wno-unused-function" Enables most compiler optimizations, disables cppcheck-internal debugging code and enables basic compiler warnings.

g++ (for experts)

If you just want to build Cppcheck without dependencies then you can use this command:

g++ -o cppcheck -std=c++11 -Iexternals -Iexternals/simplecpp -Iexternals/tinyxml2 -Iexternals/picojson -Ilib cli/*.cpp lib/*.cpp externals/simplecpp/simplecpp.cpp externals/tinyxml2/*.cpp

If you want to use --rule and --rule-file then dependencies are needed:

g++ -o cppcheck -std=c++11 -lpcre -DHAVE_RULES -Ilib -Iexternals -Iexternals/simplecpp -Iexternals/tinyxml2 cli/*.cpp lib/*.cpp externals/simplecpp/simplecpp.cpp externals/tinyxml2/*.cpp



If you encounter the following error with MATCHCOMPILER=yes you need to specify your Python interpreter via PYTHON_INTERPRETER.

process_begin: CreateProcess(NULL, which python3, ...) failed.
makefile:24: pipe: No error
process_begin: CreateProcess(NULL, which python, ...) failed.
makefile:27: pipe: No error
makefile:30: *** Did not find a Python interpreter.  Stop.

Other Compiler/IDE

  1. Create an empty project file / makefile.
  2. Add all cpp files in the cppcheck cli and lib folders to the project file / makefile.
  3. Add all cpp files in the externals folders to the project file / makefile.
  4. Compile.

Cross compiling Win32 (CLI) version of Cppcheck in Linux

sudo apt-get install mingw32
make CXX=i586-mingw32msvc-g++ LDFLAGS="-lshlwapi" RDYNAMIC=""
mv cppcheck cppcheck.exe


You can install Cppcheck with yum/apt/brew/etc.

The official rpms are built with these files: