LOC 统计指标的含义
代码行数(LOC)是经典的项目规模指标——虽有缺陷,但对估算工作量、评估代码审查负担和回答「我们写了多少代码」仍然有用。更实用的分类是代码行、注释行和空行:注释占比高通常意味着文件复杂或文档完善;空行占比高可能说明结构不佳;单个文件代码量过大则是需要重构的信号。
统计方式
- 代码行——非空且不是注释的行。
- 注释行——整行注释加上块注释内容(根据选择器,C 风格 /* */ 或 Python 三引号字符串)。
- 空行——仅包含空白字符的行。
- 行内注释(代码后跟 //)按代码行计——与 tokei/cloc 的行为一致。
实际应用
- 工作量估算:在成熟的代码库中,有经验的开发者每天净增约 100–300 行代码。
- 代码审查:1000 行的文件比 100 行的文件更需要拆分,与代码质量无关。
- 统计文档时可搭配字数统计器(Word Counter)使用;统计前整理代码可用 SQL 格式化器(SQL Formatter)。