核心用法
Code Stats 是一款轻量级的代码库分析工具，通过遍历指定目录快速生成项目度量数据。默认分析当前工作目录，也可通过参数指定任意路径。输出为结构化 JSON，包含三大核心指标：文件总数、代码行数（近似统计）及按扩展名分组的语言分布。
显著优点
- 极简零配置：无需安装依赖，单文件 Node.js 脚本即开即用
- 快速概览：秒级获取项目规模快照，适合技术尽职调查或进度汇报
- 标准输出：JSON 格式便于管道化集成，可对接 CI/CD 或数据可视化工具
- 语言无关：基于文件扩展名识别，天然支持多语言混合项目
潜在局限
- 行数精度有限："近似统计"可能包含空行、注释或配置文件，不反映有效代码量
- 无代码质量指标：仅度量规模，不分析复杂度、重复度或技术债务
- 扩展名依赖：非常规命名或无扩展名文件（如 Makefile）归类可能失真
- 单线程遍历：超大型仓库（百万级文件）可能存在性能瓶颈
适合人群
- 技术负责人快速评估接手项目的规模
- 开发者生成 README 或技术文档时引用统计数据
- PM/CTO 进行多项目横向对比与资源规划
- 开源维护者追踪社区贡献增长趋势
常规风险
- 路径注入：若未过滤输入参数，可能意外遍历系统敏感目录（如
../../etc） - 符号链接循环：遇到循环链接时可能陷入无限递归，需确认脚本是否已做防护
- 大文件/二进制误计：图片、构建产物等若被计入行数会导致数据失真
- 隐私泄露：统计结果若包含路径信息，可能暴露内部项目结构
建议生产环境使用时配合路径白名单与文件类型过滤。