用途:为 .NET 仓库生成可重复的代码行数(LOC)、语言构成与分支差异统计,回答代码足迹、组成结构、变更增量等具体问题。不用于以原始 LOC 评判开发者效率,也不替代行为验证、架构评审或复杂度分析。
主要能力:支持按 git 仓库统计、按目录范围统计,以及用 --git --diff BASE HEAD 对比命名 ref(如 origin/main..HEAD、发布分支与 main、重构前后)。可优先输出 C# 足迹、测试与生产代码对比、C#/Razor/XML/JSON/YAML/MSBuild 等语言组合。统计前应排除 bin、obj、.git 及不参与决策的 vendored 或生成目录。可用 --json、--csv、--yaml、--md 输出机器可读结果,供文档、CI 或后续自动化消费。
用法:先读取最近的 AGENTS.md 确认范围与约束;选择计数模式;排除噪声;记录准确命令。示例命令保持原样:cloc --vcs=git --include-lang="C#,MSBuild,JSON,XML,YAML"、cloc --by-file --vcs=git --include-lang="C#"、cloc --git --diff origin/main HEAD --include-lang="C#"。若未安装,可检测 command -v cloc、cloc --version、perl --version,并按平台安装:brew install cloc、sudo apt install cloc、sudo yum install cloc、sudo dnf install cloc、npm install -g cloc、choco install cloc、scoop install cloc,或 docker run --rm -v $PWD:/tmp aldanial/cloc .。
适用场景:C# 代码库规模评估、解决方案组成分析、CI 中的行数报告、重构或版本间的代码量差异比较。
限制:cloc 只作为规模与比较工具,不能证明设计优劣;应校验计数边界是否包含构建产物噪声;若仓库有意使用其他代码统计工具,可标记为 not_applicable。具体配置细节与参考见 references/commands.md、references/examples.md、references/cloc.md。