程序员必备工具：使用 cloc 统计项目代码量

在开发大型 C++ 项目时，我们经常需要量化工作量。cloc (Count Lines of Code) 是目前最流行的代码统计工具，它能快速识别代码、注释和空行，并支持数百种编程语言。

一、 安装指南：解决“访问被拒绝”报错

你在安装时遇到的 UnauthorizedAccessException 错误，是因为没有使用管理员权限。

1. 正确的安装步骤

打开管理员终端：点击“开始”菜单，输入 cmd，右键点击“以管理员身份运行”。
执行安装命令：

choco install cloc

验证安装：安装完成后，输入以下命令。如果显示版本号（如 2.8.0），说明安装成功：

cloc --version

2. 进阶提示：如果依然报错

如果管理员模式下仍提示 lock file access（文件锁冲突），请手动删除报错信息中的残留文件： del C:\ProgramData\chocolatey\lib\ff4df4dfe76c...（完整文件名见你的报错日志）。

二、 使用教程：如何统计你的 C++ 项目

安装完成后，你可以直接在命令行中使用它。

1. 基础用法：统计当前目录

进入你的项目根目录，运行：

cloc .

它会扫描当前文件夹下所有的源代码，并按语言分类显示。
2. 排除干扰：忽略第三方库
你的项目中可能包含库的源码，如果只想统计你自己写的代码，可以使用 --exclude-dir 参数：

cloc . --exclude-dir=build

这将跳过名为 build 的文件夹。

3. 输出为文件
   如果你需要将统计结果保存到文档中（例如用于项目汇报），可以运行：

cloc . --report-file=code_stats.txt

三、 为什么 C++ 开发者需要它？
对于使用 C++ 的开发人员，cloc 可以帮你清晰地看到：
代码逻辑分布：了解你的核心算法（.cpp）与 UI 布局的比例。
注释率：优秀的工程通常有 20%-30% 的注释。如果你的注释率过低，可能需要补充技术文档。