SuperAPI AI 工具集

dotnet-cloc

数据与分析

查看项目

更新于 10-16 00:05

技能介绍

用途:在 .NET 仓库中使用开源免费工具 cloc 生成可重复的代码行数、语言构成和分支差异统计,回答代码库规模、解决方案组成或不同引用之间代码量变化等问题。

主要能力:支持按仓库统计(--vcs=git)、按路径限定范围统计,以及分支差异统计(--git --diff BASE HEAD)。可优先输出 .NET 相关视图,如 C# 代码量、测试与生产代码对比,以及 C#、Razor、XML、JSON、YAML、MSBuild 等语言构成。支持机器可读输出:--json、--csv、--yaml、--md。统计前可排除 bin、obj、.git 及 vendored 或生成目录等噪声。

使用方式:先读取最近的 AGENTS.md 确认范围与约束,再按需选择统计模式。若未安装 cloc,可先检测:command -v cloc、cloc --version、perl --version。安装方式包括:macOS 用 brew install cloc;Debian/Ubuntu 用 sudo apt install cloc;Red Hat 旧版用 sudo yum install cloc;Fedora 或新版 Red Hat 用 sudo dnf install cloc;npm 回退用 npm install -g cloc;Windows 用 choco install cloc 或 scoop install cloc;Docker 回退用 docker run --rm -v $PWD:/tmp aldanial/cloc .。示例命令: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#"。

适用场景:为 .NET 仓库添加可重复的行数与语言构成报告;比较 main 与分支的代码规模;统计解决方案中 C# 与测试代码占比;为 CI 或文档生成机器可读的行数报告。

限制:cloc 仅作为规模与比较工具,不能用于评判开发者生产力,也不能替代行为验证、架构评审或复杂度分析。不应在无明确理由时统计生成或 vendored 文件。基于 cloc 结果做代码清理后,仍需运行仓库常规质量检查。若仓库有意使用其他代码统计工具,可返回 not_applicable。