简介这是一款面向C与C语言开发者的代码统计工具可分析源码文件中的代码行、空行与注释行帮助评估项目规模、代码密度与可维护性适合需要监控代码质量、复盘重构效果的初中级程序员使用。压缩包共102个文件约7.04MB包含9个cpp与11个h源文件、1个exe可执行程序以及dsp、dsw等工程配置文件和ico、bmp等界面资源另有obj、pdb、sbr等编译中间产物整体为完整的MFC工程结构。目前已有883人学习下载。工具支持区分单行与多行注释可统计整体行数、分类统计各模块代码与注释数量并计算有效代码行与代码密度便于对比不同阶段的统计结果、评估重构或优化成效也可用于开源项目规模与活跃度的初步判断是提升开发效率、优化代码质量的实用辅助手段。1. 从一份 C 代码统计工具说起为什么行数与注释统计总对不上接手一个十几万行的 C/C 老项目时第一件让人头疼的事往往不是编译报错而是没人说得清这套代码到底有多少行、注释占多少、有效代码又有多少。用wc -l一把梭结果把空行、//注释、块注释全算进去报出来的数字虚高得离谱换个 IDE 自带的统计插件遇到宏定义里的续行符\又开始翻车。这也是为什么我一直在找一个能真正区分「代码行 / 注释行 / 空行」的 C 代码统计工具——它要能同时吃下.c和.cpp能识别//、/* */两种注释风格还得把字符串字面量里的//排除掉不然printf(http://...)这种代码会被误判成注释。这份 CodeAnalysis 工具就是冲着这个场景来的它用 C 写成专门统计 C 代码和 C 代码的行数、注释行数、空行数输出有效代码占比。适合谁用接手遗留项目的维护者、做代码审计的测试同学、需要给毕业论文凑代码量统计的学生以及想给自己项目做一次「体检」的开发者。下面我按「它怎么算 → 怎么跑起来 → 坑在哪 → 怎么进阶」的顺序拆一遍。2. 统计逻辑拆解注释行、空行、有效代码行到底怎么分2.1 三种行类型的判定规则代码统计工具的核心不是数行而是分类。一份.cpp文件里的每一行最终会被归到下面三类之一行类型判定条件典型例子空行去掉首尾空白后长度为 0只有空格或 Tab 的行注释行整行只包含注释内容// 初始化、/* 块注释 */代码行含有非注释、非空白的有效字符int a 0;难点在于混合行int a 0; // 初始化变量这种既有代码又有注释的行到底算代码还是注释常见做法是归为代码行注释部分单独计数。工具如果只做「整行判定」就会把这类行漏掉导致注释率偏低。我在实际项目里见过注释率报出来只有 3% 的情况一查就是混合行没被识别。2.2 状态机处理块注释跨行的关键单行注释//好处理一行扫过去遇到就截断。真正麻烦的是/* ... */块注释它可能跨几十行中间还夹着代码。合格的工具必须用一个状态机来跟踪当前是否处于块注释中// 简化版状态机核心逻辑 enum State { NORMAL, IN_BLOCK_COMMENT, IN_STRING }; State state NORMAL; for (char c : line) { if (state NORMAL) { if (c / next /) break; // 行注释本行剩余忽略 if (c / next *) state IN_BLOCK_COMMENT; if (c ) state IN_STRING; // 进入字符串屏蔽注释符 } else if (state IN_BLOCK_COMMENT) { if (c * next /) state NORMAL; } else if (state IN_STRING) { if (c prev ! \\) state NORMAL; } }这段逻辑里三个状态缺一不可。IN_STRING状态是为了防止http://x里的//被当成注释IN_BLOCK_COMMENT是为了让跨行块注释的每一行都被正确归为注释行。参数上prev ! \\用来处理转义引号\否则字符串里出现转义引号就会提前退出字符串状态后面的注释符又被误判。2.3 续行符与预处理指令的处理C/C 里#define宏可以用反斜杠\续行一个宏可能横跨十几行。如果工具不处理续行符会把宏的每一行都当成独立代码行统计结果虚高。常见做法是遇到行尾是\时把下一行拼接到当前行再统一判定。另外#include、#pragma这类预处理指令一般归为代码行但有些团队希望单独统计这取决于工具是否提供开关。3. 把工具跑起来编译、传参、批量统计一个项目3.1 编译环境与依赖这份工具是纯 C 实现没有第三方库依赖用常见的 g 或 MSVC 都能编。Windows 上如果提示缺运行库装一下 Microsoft Visual C Redistributable 即可这是很多 C 小工具的通病不是工具本身的问题。Linux/macOS 下直接 g 一把过。# Linux / macOS 编译 g -stdc17 -O2 -o codeanalysis main.cpp counter.cpp # Windows (MinGW) g -stdc17 -O2 -o codeanalysis.exe main.cpp counter.cpp-stdc17是因为源码里用了std::filesystem做目录遍历低于 C17 会编译失败。-O2是优化等级统计大项目时能明显提速。如果你的编译器版本较老把std::filesystem换成dirent.h也能跑但需要改几处路径拼接代码。3.2 单文件与目录两种调用方式工具一般支持两种模式传单个文件或传一个目录递归统计。命令行参数设计上常见做法是第一个参数为路径后面跟可选开关。# 统计单个文件 ./codeanalysis ./src/main.cpp # 递归统计整个目录只统计 .c 和 .cpp ./codeanalysis ./src --ext .c,.cpp # 输出详细模式列出每个文件的明细 ./codeanalysis ./src --ext .c,.cpp --verbose--ext参数用来过滤扩展名不传的话默认只认.c、.cpp、.h、.hpp。--verbose会逐文件打印行数、注释行、空行最后再给一个汇总。批量统计一个中型项目约 500 个文件大概几秒出结果速度上不用担心。3.3 输出结果怎么读典型输出长这样File: src/main.cpp Total: 320 Code: 210 Comment: 78 Blank: 32 Comment%: 24.4% Summary: Files: 128 Total: 45210 Code: 31890 Comment: 8210 Blank: 5110 Comment%: 18.2%重点看Comment%这一列。业界没有硬性标准但经验上核心模块注释率低于 10% 就要警惕了说明后续维护成本会很高。Code行数才是真正反映工作量的数字汇报时别拿Total去说事容易被懂行的人一眼看穿。4. 避坑与排查统计结果对不上时先查这几处4.1 注释率异常偏低现象一个注释写得很勤的项目统计出来注释率只有个位数。原因混合行代码 行尾注释被整行归为代码行注释部分没被单独计数。解决确认工具是否支持混合行拆分。如果不支持可以先用正则把行尾//后面的内容单独抽出来估算或者换一个支持混合行统计的版本。4.2 字符串里的注释符被误判现象代码里写了const char* url http://example.com;结果这一行之后的内容全被当成注释吞掉。原因状态机没有进入字符串状态把//当成了行注释起始。解决检查工具是否处理了字符串字面量。自己改的话在NORMAL状态遇到时切到IN_STRING遇到未转义的再切回来。4.3 块注释跨行统计错位现象一个 20 行的/* ... */块注释只统计出 1 行注释。原因工具只做了单行判定没有跨行状态保持。解决必须用状态机。如果工具本身不支持可以在统计前用脚本把块注释统一替换成等量的//行再喂给工具这是常见的绕行做法。4.4 编码问题导致中文注释乱码现象源码是 GBK 编码工具按 UTF-8 读中文注释变成乱码行数统计不受影响但注释内容显示异常。原因文件编码与工具默认编码不一致。解决统计行数其实不受编码影响因为判定的是字节而非字符。但如果工具要输出注释内容就得统一编码。VS Code 里右下角可以切换编码批量转换用iconv即可。4.5 宏定义续行导致行数虚高现象一个用了大量#define宏的项目统计出的代码行数比实际多出几千行。原因续行符\没被处理宏的每一行都被当成独立代码行。解决统计前先做续行拼接或者确认工具是否内置了续行处理。没有的话用sed把行尾\和下一行合并再统计。5. 进阶玩法把统计结果接进 CI 与自定义规则5.1 用退出码做 CI 卡点工具可以约定当注释率低于阈值时返回非零退出码这样就能直接挂到 CI 流水线里做质量门禁。# 注释率低于 15% 时构建失败 ./codeanalysis ./src --ext .c,.cpp --min-comment 15 if [ $? -ne 0 ]; then echo 注释率不达标请补充注释 exit 1 fi--min-comment是自定义阈值参数单位是百分比。这个用法在团队里推过一次效果比开会强调注释规范好得多——数字摆在那里谁也没法装看不见。参数建议设在 10% 到 20% 之间太高会逼着人写废话注释反而有害。5.2 输出 CSV 做趋势追踪把每次统计结果追加到 CSV用表格工具画个趋势图能直观看到注释率是升是降。# 追加一行到统计日志 echo $(date %F),$(./codeanalysis ./src --ext .c,.cpp --csv) stats.csv--csv输出格式为total,code,comment,blank,comment_pct方便直接解析。坚持记录几周你会发现注释率下降往往和赶工期强相关这比任何复盘会都直观。5.3 自定义规则排除第三方目录项目里通常有third_party/、vendor/这类目录统计时应该排除否则数字会被别人的代码稀释。./codeanalysis ./src --ext .c,.cpp --exclude third_party,vendor,build--exclude接受逗号分隔的目录名匹配到的目录整棵跳过。这个参数我每次都会带上血泪经验是有一次忘了排除build/结果把 CMake 生成的中间文件也算进去代码量直接翻倍汇报时差点闹笑话。5.4 一个容易忽略的细节头文件算不算.h和.hpp到底算不算代码量团队之间经常吵。我的习惯是分开统计.c/.cpp算实现代码.h/.hpp单独列一栏。工具如果支持--group参数就能按扩展名分组输出不支持的话跑两次分别指定--ext即可。从那以后我每次做代码统计都会先把头文件和实现文件分开跑一遍再合并看总数这样汇报时无论对方怎么问都答得上来。希望这份拆解能帮到你把手里那套 C/C 代码真正数清楚。本文还有配套的精品资源点击获取 C++代码统计工具：精准区分代码行、注释行与空行
简介这是一款面向C与C语言开发者的代码统计工具可分析源码文件中的代码行、空行与注释行帮助评估项目规模、代码密度与可维护性适合需要监控代码质量、复盘重构效果的初中级程序员使用。压缩包共102个文件约7.04MB包含9个cpp与11个h源文件、1个exe可执行程序以及dsp、dsw等工程配置文件和ico、bmp等界面资源另有obj、pdb、sbr等编译中间产物整体为完整的MFC工程结构。目前已有883人学习下载。工具支持区分单行与多行注释可统计整体行数、分类统计各模块代码与注释数量并计算有效代码行与代码密度便于对比不同阶段的统计结果、评估重构或优化成效也可用于开源项目规模与活跃度的初步判断是提升开发效率、优化代码质量的实用辅助手段。1. 从一份 C 代码统计工具说起为什么行数与注释统计总对不上接手一个十几万行的 C/C 老项目时第一件让人头疼的事往往不是编译报错而是没人说得清这套代码到底有多少行、注释占多少、有效代码又有多少。用wc -l一把梭结果把空行、//注释、块注释全算进去报出来的数字虚高得离谱换个 IDE 自带的统计插件遇到宏定义里的续行符\又开始翻车。这也是为什么我一直在找一个能真正区分「代码行 / 注释行 / 空行」的 C 代码统计工具——它要能同时吃下.c和.cpp能识别//、/* */两种注释风格还得把字符串字面量里的//排除掉不然printf(http://...)这种代码会被误判成注释。这份 CodeAnalysis 工具就是冲着这个场景来的它用 C 写成专门统计 C 代码和 C 代码的行数、注释行数、空行数输出有效代码占比。适合谁用接手遗留项目的维护者、做代码审计的测试同学、需要给毕业论文凑代码量统计的学生以及想给自己项目做一次「体检」的开发者。下面我按「它怎么算 → 怎么跑起来 → 坑在哪 → 怎么进阶」的顺序拆一遍。2. 统计逻辑拆解注释行、空行、有效代码行到底怎么分2.1 三种行类型的判定规则代码统计工具的核心不是数行而是分类。一份.cpp文件里的每一行最终会被归到下面三类之一行类型判定条件典型例子空行去掉首尾空白后长度为 0只有空格或 Tab 的行注释行整行只包含注释内容// 初始化、/* 块注释 */代码行含有非注释、非空白的有效字符int a 0;难点在于混合行int a 0; // 初始化变量这种既有代码又有注释的行到底算代码还是注释常见做法是归为代码行注释部分单独计数。工具如果只做「整行判定」就会把这类行漏掉导致注释率偏低。我在实际项目里见过注释率报出来只有 3% 的情况一查就是混合行没被识别。2.2 状态机处理块注释跨行的关键单行注释//好处理一行扫过去遇到就截断。真正麻烦的是/* ... */块注释它可能跨几十行中间还夹着代码。合格的工具必须用一个状态机来跟踪当前是否处于块注释中// 简化版状态机核心逻辑 enum State { NORMAL, IN_BLOCK_COMMENT, IN_STRING }; State state NORMAL; for (char c : line) { if (state NORMAL) { if (c / next /) break; // 行注释本行剩余忽略 if (c / next *) state IN_BLOCK_COMMENT; if (c ) state IN_STRING; // 进入字符串屏蔽注释符 } else if (state IN_BLOCK_COMMENT) { if (c * next /) state NORMAL; } else if (state IN_STRING) { if (c prev ! \\) state NORMAL; } }这段逻辑里三个状态缺一不可。IN_STRING状态是为了防止http://x里的//被当成注释IN_BLOCK_COMMENT是为了让跨行块注释的每一行都被正确归为注释行。参数上prev ! \\用来处理转义引号\否则字符串里出现转义引号就会提前退出字符串状态后面的注释符又被误判。2.3 续行符与预处理指令的处理C/C 里#define宏可以用反斜杠\续行一个宏可能横跨十几行。如果工具不处理续行符会把宏的每一行都当成独立代码行统计结果虚高。常见做法是遇到行尾是\时把下一行拼接到当前行再统一判定。另外#include、#pragma这类预处理指令一般归为代码行但有些团队希望单独统计这取决于工具是否提供开关。3. 把工具跑起来编译、传参、批量统计一个项目3.1 编译环境与依赖这份工具是纯 C 实现没有第三方库依赖用常见的 g 或 MSVC 都能编。Windows 上如果提示缺运行库装一下 Microsoft Visual C Redistributable 即可这是很多 C 小工具的通病不是工具本身的问题。Linux/macOS 下直接 g 一把过。# Linux / macOS 编译 g -stdc17 -O2 -o codeanalysis main.cpp counter.cpp # Windows (MinGW) g -stdc17 -O2 -o codeanalysis.exe main.cpp counter.cpp-stdc17是因为源码里用了std::filesystem做目录遍历低于 C17 会编译失败。-O2是优化等级统计大项目时能明显提速。如果你的编译器版本较老把std::filesystem换成dirent.h也能跑但需要改几处路径拼接代码。3.2 单文件与目录两种调用方式工具一般支持两种模式传单个文件或传一个目录递归统计。命令行参数设计上常见做法是第一个参数为路径后面跟可选开关。# 统计单个文件 ./codeanalysis ./src/main.cpp # 递归统计整个目录只统计 .c 和 .cpp ./codeanalysis ./src --ext .c,.cpp # 输出详细模式列出每个文件的明细 ./codeanalysis ./src --ext .c,.cpp --verbose--ext参数用来过滤扩展名不传的话默认只认.c、.cpp、.h、.hpp。--verbose会逐文件打印行数、注释行、空行最后再给一个汇总。批量统计一个中型项目约 500 个文件大概几秒出结果速度上不用担心。3.3 输出结果怎么读典型输出长这样File: src/main.cpp Total: 320 Code: 210 Comment: 78 Blank: 32 Comment%: 24.4% Summary: Files: 128 Total: 45210 Code: 31890 Comment: 8210 Blank: 5110 Comment%: 18.2%重点看Comment%这一列。业界没有硬性标准但经验上核心模块注释率低于 10% 就要警惕了说明后续维护成本会很高。Code行数才是真正反映工作量的数字汇报时别拿Total去说事容易被懂行的人一眼看穿。4. 避坑与排查统计结果对不上时先查这几处4.1 注释率异常偏低现象一个注释写得很勤的项目统计出来注释率只有个位数。原因混合行代码 行尾注释被整行归为代码行注释部分没被单独计数。解决确认工具是否支持混合行拆分。如果不支持可以先用正则把行尾//后面的内容单独抽出来估算或者换一个支持混合行统计的版本。4.2 字符串里的注释符被误判现象代码里写了const char* url http://example.com;结果这一行之后的内容全被当成注释吞掉。原因状态机没有进入字符串状态把//当成了行注释起始。解决检查工具是否处理了字符串字面量。自己改的话在NORMAL状态遇到时切到IN_STRING遇到未转义的再切回来。4.3 块注释跨行统计错位现象一个 20 行的/* ... */块注释只统计出 1 行注释。原因工具只做了单行判定没有跨行状态保持。解决必须用状态机。如果工具本身不支持可以在统计前用脚本把块注释统一替换成等量的//行再喂给工具这是常见的绕行做法。4.4 编码问题导致中文注释乱码现象源码是 GBK 编码工具按 UTF-8 读中文注释变成乱码行数统计不受影响但注释内容显示异常。原因文件编码与工具默认编码不一致。解决统计行数其实不受编码影响因为判定的是字节而非字符。但如果工具要输出注释内容就得统一编码。VS Code 里右下角可以切换编码批量转换用iconv即可。4.5 宏定义续行导致行数虚高现象一个用了大量#define宏的项目统计出的代码行数比实际多出几千行。原因续行符\没被处理宏的每一行都被当成独立代码行。解决统计前先做续行拼接或者确认工具是否内置了续行处理。没有的话用sed把行尾\和下一行合并再统计。5. 进阶玩法把统计结果接进 CI 与自定义规则5.1 用退出码做 CI 卡点工具可以约定当注释率低于阈值时返回非零退出码这样就能直接挂到 CI 流水线里做质量门禁。# 注释率低于 15% 时构建失败 ./codeanalysis ./src --ext .c,.cpp --min-comment 15 if [ $? -ne 0 ]; then echo 注释率不达标请补充注释 exit 1 fi--min-comment是自定义阈值参数单位是百分比。这个用法在团队里推过一次效果比开会强调注释规范好得多——数字摆在那里谁也没法装看不见。参数建议设在 10% 到 20% 之间太高会逼着人写废话注释反而有害。5.2 输出 CSV 做趋势追踪把每次统计结果追加到 CSV用表格工具画个趋势图能直观看到注释率是升是降。# 追加一行到统计日志 echo $(date %F),$(./codeanalysis ./src --ext .c,.cpp --csv) stats.csv--csv输出格式为total,code,comment,blank,comment_pct方便直接解析。坚持记录几周你会发现注释率下降往往和赶工期强相关这比任何复盘会都直观。5.3 自定义规则排除第三方目录项目里通常有third_party/、vendor/这类目录统计时应该排除否则数字会被别人的代码稀释。./codeanalysis ./src --ext .c,.cpp --exclude third_party,vendor,build--exclude接受逗号分隔的目录名匹配到的目录整棵跳过。这个参数我每次都会带上血泪经验是有一次忘了排除build/结果把 CMake 生成的中间文件也算进去代码量直接翻倍汇报时差点闹笑话。5.4 一个容易忽略的细节头文件算不算.h和.hpp到底算不算代码量团队之间经常吵。我的习惯是分开统计.c/.cpp算实现代码.h/.hpp单独列一栏。工具如果支持--group参数就能按扩展名分组输出不支持的话跑两次分别指定--ext即可。从那以后我每次做代码统计都会先把头文件和实现文件分开跑一遍再合并看总数这样汇报时无论对方怎么问都答得上来。希望这份拆解能帮到你把手里那套 C/C 代码真正数清楚。本文还有配套的精品资源点击获取