From 0feee5dc2e1f1ec7098449b362fc99aca2f582be Mon Sep 17 00:00:00 2001 From: Wanderingss <1624155937@qq.com> Date: Thu, 19 Nov 2026 13:04:55 +0800 Subject: [PATCH] =?UTF-8?q?chore(gate):=20=E4=BF=AE=20cppcheck=20=E4=B8=A4?= =?UTF-8?q?=E6=A0=B9=E9=92=A9=E5=AD=90=E7=9A=84=E5=8F=97=E6=A3=80=E8=8C=83?= =?UTF-8?q?=E5=9B=B4=E6=BC=8F=E9=85=8D?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 装真 cppcheck 2.21.0 后第一次真正跑起来这两根钩子,暴露两处范围漏配。 ## 一、cppcheck 钩子漏排除 IEC60870-Slave/ 钩子自己的注释写着"仅扫描项目自有代码;排除第三方库",但 exclude 里没有 IEC60870-Slave/。判定为漏配而非有意设计,三条证据: 1. 同一目录早已在 coding-standard 的 exclude 里,而那个钩子的注释明确写 "范围与 cppcheck 钩子一致"——两边实际不一致。 2. 该排除项由 90cc9a7d 加进 coding-standard 段时没有同步 cppcheck 段, 之后 7 个提交都没补;原因是这根钩子从来没真跑起来过(见第二节), 谁也不知道差 726 条。 3. 该目录不进任何构建:uvprojx 命中 0、simulator/CMakeLists.txt 命中 0, 208 个跟踪文件仅被 test/host/iec104_dtu 当参考语料引用。 代价实测:全库 834 条命中里 726 条来自该目录,把真正需要看的那几条完全淹没。 排除后 834 → 106 条。 ## 二、test-cppcheck 钩子把自检变异体当被测代码扫 失败项全来自 test/host/iec104_netmcu/results/static_mutant/iec104_net_mcu_BAD.c ——它由 check_static_selftest.py 故意写坏,用来反证静态检查器真能报错 (results/static_mutant/report.json 记 real_rc=0 / mutant_rc=1)。扫它必然报警, 而那恰恰是自检有效的证据。与已存在的三个 stub 的 -i 同一性质。 排除后整个 test/ 扫描 rc=0 零命中。 ## 验证 - pre_commit validate-config rc=0 - cppcheck 钩子:834 → 106 条(IEC60870-Slave 组归零) - test-cppcheck 钩子:Failed → Passed,0 命中 --- .pre-commit-config.yaml | 13 +++++++++++++ 1 file changed, 13 insertions(+) diff --git a/.pre-commit-config.yaml b/.pre-commit-config.yaml index 58825488..5853adf9 100644 --- a/.pre-commit-config.yaml +++ b/.pre-commit-config.yaml @@ -100,12 +100,19 @@ repos: types: [c] # 仅扫描项目自有代码;排除第三方库与 LVGL 依赖文件 # (UI 生成文件 ui_font_cn_12/ui_menu_tab 由生成器按工程约定产出,纳入受检) + # ⚠ `IEC60870-Slave/` 必须排除(2026-11-19 补):它是不进任何构建的第三方快照 + # (uvprojx 命中 0、simulator/CMakeLists.txt 命中 0),仅被 test/host/iec104_dtu + # 当参考语料引用。本钩子此前漏配这一行,而 coding-standard 的 exclude 早已有它 + # (那个钩子注释写着「范围与 cppcheck 钩子一致」,两边实际不一致)。 + # 漏配的代价实测 = 726 条存量命中:装真 cppcheck 2.21.0 后全库 834 条, + # 其中 726 条来自这个目录,把真正需要看的那几条完全淹没。 exclude: | (?x)^( Drivers/CMSIS/| Drivers/STM32F4xx_HAL_Driver/| Drivers/BSP/NET/lftpd/| Drivers/BSP/dhara/| + IEC60870-Slave/| Lib/| Middlewares/| MDK-ARM/| @@ -135,6 +142,12 @@ repos: '-i', 'test/host/watchdog/stub', '-i', 'test/host/cfg_file/stub', '-i', 'test/host/sys_clock/stub', + # `results/` 下放的是构建产物与自检变异体,不是被测代码(2026-11-19 补): + # `results/static_mutant/iec104_net_mcu_BAD.c` 由 check_static_selftest.py + # **故意写坏**,用来反证静态检查器真能报错(report 里记 real_rc=0 / + # mutant_rc=1)。扫它必然报警,而那恰恰是自检有效的证据,不是缺陷。 + # 与上面三个 stub 的 `-i` 同一性质:形态不受控,不当被测代码看。 + '-i', 'test/host/iec104_netmcu/results', '-I', 'Inc', '-I', 'App', '-I', 'Drivers/BSP', '-I', 'Drivers/STM32F4xx_HAL_Driver/Inc', '-I', 'Drivers/CMSIS/Include', '-I', 'Middlewares/Third_Party/FreeRTOS/Source/include',