cloc(代码行数统计)

cloc(Count Lines of Code)是一款开源的命令行工具,用于统计源代码文件中的行数,并按代码行、注释行与空行分类汇总。它能识别数百种编程语言,是快速了解项目规模与构成的常用工具。

概述

cloc 由 Al Danial 开发,用 Perl 编写,以单一脚本形式发布,采用 GPL 许可证开源。它无需复杂安装,可直接对文件、目录甚至压缩包与 Git 仓库运行。相比简单地用 wc 数行数,cloc 能智能区分真正的代码与注释、空白,给出更有意义的统计。

核心特点

• 多语言识别:内置对数百种语言的语法规则,按扩展名与内容判定文件类型。
• 三类计数:分别统计空行、注释行与实际代码行,而非笼统的总行数。
• 灵活输入:支持目录递归、文件列表、压缩归档,以及两次快照的差异对比。
• 多种输出:可输出为文本表格,或 JSON、XML、CSV 等便于程序处理的格式。
• 零依赖运行:作为单文件脚本,便于在各种环境中快速使用。

应用场景

项目负责人常用 cloc 快速评估代码库的规模与语言占比,为工作量估算和技术盘点提供参考。在开源项目中,它常出现在文档里用于展示各语言代码量。团队还可用其差异功能比较两个版本之间代码行数的增减,辅助了解迭代的改动幅度。

常见问题

问:cloc 统计的代码行等于工作量吗?答:不等于。代码行数只是粗略的规模指标,并不能直接衡量质量、复杂度或真实工作量,应谨慎解读。

问:cloc 会把生成代码或第三方库也算进去吗?答:默认会统计所有匹配文件,但可通过排除目录或文件规则过滤掉依赖库与自动生成的代码,以得到更准确的结果。