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