用途:借助 pygount 分析代码仓库的代码行数、语言分布、文件数量以及代码与注释行数的比例,回答“这个仓库有多大”“由哪些语言组成”一类问题。
主要能力:提供语言维度的汇总表(语言、文件数、代码行、注释行、占比);可只统计指定后缀语言;可输出逐文件明细;支持 summary 与 json 等输出格式。
使用方式:先安装工具,命令为 pip install --break-system-packages pygount 2>/dev/null || pip install pygount。随后进入仓库目录执行 pygount。常用汇总命令为:cd /path/to/repo 后运行 pygount --format=summary --folders-to-skip=".git,node_modules,venv,.venv,pycache,.cache,dist,build,.next,.tox,.eggs,*.egg-info" . 。可按项目类型调整排除目录;只统计某语言可用 --suffix=py 或 --suffix=py,yaml,yml;逐文件输出可省略 --format,也可用 sort 按代码行排序后取前若干行;需程序化处理时用 --format=json。
结果解读:汇总列含义为语言、文件数、代码行、注释行与占比;伪语言包括 empty、binary、generated、duplicate 和 unknown。
限制与注意:务必使用 --folders-to-skip 排除依赖与构建目录,否则可能耗时很长或卡住;Markdown 会被全部计为注释,代码行显示为 0;JSON 行数统计偏保守,精确统计建议用 wc -l;超大 monorepo 建议用 --suffix 限定语言范围。