使用 cloc 高效统计代码行数

在项目管理和开发过程中，了解代码规模是一个常见的需求。cloc (Count Lines of Code) 是一款强大的开源命令行工具，它能够识别数百种编程语言，并准确统计出空行、注释行及物理代码行数。

1. 安装方式

Windows 环境

推荐使用包管理器进行安装。以管理员身份打开 PowerShell，运行：

choco install cloc

提示：如果没有安装 Chocolatey，也可以通过 scoop install cloc 或直接从 GitHub Release 页面下载 exe 文件。

macOS 环境

brew install cloc

Linux 环境

sudo apt install cloc  # Debian/Ubuntu
sudo yum install cloc  # RedHat/CentOS

2. 基础用法

进入项目根目录，运行以下命令即可统计当前目录下所有受支持的代码文件：

cloc .

3. 进阶用法：排除干扰目录

现代项目通常包含大量的第三方库、依赖包或构建产物。如果不进行过滤，统计结果会包含这些非原创代码，导致数据失真。使用 --exclude-dir 参数可以有效解决这个问题。

常用排除命令

cloc . --exclude-dir=.venv,node_modules,Pods,dist,build,target,.git,.vscode,__pycache__

常见的排除目录建议： - 前端： node_modules, dist - Python： .venv, __pycache__ - Java： target, .gradle - iOS/Flutter： Pods, .dart_tool - 版本控制： .git, .svn

4. 实用技巧补充

仅统计特定语言

如果你只想统计项目中的 Python 和 JavaScript 代码：

cloc . --include-lang=Python,"JavaScript"

统计压缩包内的代码

cloc 甚至可以直接统计压缩文件（如 .zip, .tar.gz）中的代码：

cloc project.zip

导出统计结果

如果你需要将结果交给其他程序处理，可以使用 JSON 或 CSV 格式输出：

cloc . --json --out=report.json

5. 总结

cloc 是一款轻量级、无依赖且功能强大的工具。通过合理配置排除目录，开发者可以快速获取核心业务代码的体量，为项目评估、工作量统计及代码审计提供可靠的数据支持。