Cppcheck不是编译器替代品，专查编译器忽略的越界、内存泄漏、空指针解引用等问题；安装后运行cppcheck --version验证，再用cppcheck test.cpp基础扫描，推荐加--enable=warning,style,performance提升检出率。
Cppcheck 不是用来替代编译器的，它专治编译器“睁一只眼闭一只眼”的问题——比如 array[i] 越界、malloc 后没 free、ptr 解引用前没判空。直接上手就能发现真实项目里埋着的硬伤，不需要运行、不依赖目标平台。
怎么装完立刻检查单个文件
安装后验证是否就绪：cppcheck --version。确认无误后，对一个 test.cpp 文件做基础扫描只需一行：
cppcheck test.cpp
默认只报 warning 级别（如未初始化变量、明显空指针），速度最快。但实际项目中容易漏掉关键隐患，所以建议至少加 --enable=warning,style,performance ——style 能揪出未使用的函数参数，performance 会提示 std::string 传值而非 const 引用这类开销问题。别一上来就用 --enable=all，否则大量 information 类提示（如“函数有 12 行”）会淹没真正该修的错误。
扫整个 C++ 项目时必须处理的三个干扰项
直接 cppcheck src/ 很可能报一堆假阳性，集中在三类：
立即学习“C++免费学习笔记（深入）”；
-
missingInclude：找不到头文件路径，尤其是自定义库或第三方模块。用-I显式指定，例如cppcheck -I./include -I./third_party/boost src/ -
unknownMacro：宏展开后类型/值不可推导（如嵌入式常用的__IO uint32_t）。加--suppress=unknownMacro或用--platform=unix64（对应常见 Linux 环境）缓解 -
unmatchedSuppression：你写了// cppcheck-suppress unusedFunction，但 cppcheck 没识别到该规则名。先查cppcheck --errorlist确认拼写，C++ 中常见的是unusedFunction而非unusedFunction（注意大小写）
生成可读报告并集成进 CI 的最小可行方案
终端输出难协作，推荐导出 HTML 报告：
cppcheck --xml-version=2 --enable=warning,style src/ 2> report.xml cppcheck-htmlreport --file=report.xml --report-dir=html-report
注意两点：
- 必须加
--xml-version=2，否则cppcheck-htmlreport会解析失败，报错信息是XML syntax error: no element found -
cppcheck-htmlreport依赖pygments，国内安装常卡住，用pip install pygments -i https://pypi.tuna.tsinghua.edu.cn/simple最稳 - CI 中需控制退出码：加
--error-exitcode=1，只要出现error级别问题（如数组越界）就让流水线失败；warning级别默认不触发失败，避免阻塞开发流
嵌入式或跨平台 C++ 项目最容易忽略的配置点
如果你的代码要跑在 STM32、RISC-V 或裸机环境，--platform 不是可选项：
- 用
--platform=arm32告诉 cppcheckint是 32 位、size_t和指针同宽，否则它可能把合法的寄存器地址强制转换误判为截断风险 - 对含
volatile的外设寄存器访问（如*(volatile uint32_t*)0x40021000 = 1;），默认会报volatileUsage。这不是 bug，而是 cppcheck 不确定你是否真需要 volatile —— 此时应加--suppress=volatileUsage，而不是删掉 volatile - 交叉编译项目务必配合
compile_commands.json：用 CMake 生成该文件后，运行cppcheck -p compile_commands.json，能准确还原宏定义和头文件路径，大幅降低误报
真正卡住人的往往不是“会不会用”，而是 --platform 选错导致满屏误报，或 compile_commands.json 没生成成功却以为路径配置对了——这两处不验证，其他所有优化都白搭。
