CodeGeeX快速评估项目规模与工作量【代码统计】

CodeGeeX提供三种本地化代码统计方式：一、CLI工具扫描项目输出结构化指标；二、VS Code插件可视化查看工作区概览；三、Python SDK支持自定义脚本集成CI或模块级分析。

想在项目初期快速摸清家底，掌握代码总量、语言分布和模块复杂度吗？好消息是，CodeGeeX的本地化代码统计功能就能帮你实现，整个过程无需部署，开箱即用。具体怎么操作？我们来看下面三种主流方法。

一、使用 CodeGeeX CLI 工具执行项目扫描

如果你习惯在终端里解决问题，CodeGeeX CLI工具会是你的得力助手。它支持离线运行，能递归扫描整个项目目录，自动识别主流编程语言文件，并且聪明地过滤掉二进制文件、构建产物这些“噪音”，最终给你一份结构清晰的统计报告。

操作起来很简单，就三步：

1. 打开终端，运行 npm install -g codegeex-cli 安装命令行工具。

2. 进入你要评估的项目根目录，执行 codegeex stats --exclude node_modules,.git,build。这里的排除项可以根据你的项目情况灵活调整。

3. 稍等片刻，扫描完成后，终端就会直接输出结果。你会看到总行数、空行、注释行、有效代码行数（LOC）这些核心指标，以及一张清晰的语言占比表格，项目规模一目了然。

二、通过 VS Code 插件可视化统计当前工作区

对于大部分时间都泡在VS Code里的开发者来说，还有更便捷的方式。CodeGeeX官方插件内置了一个轻量级的统计面板，无需任何额外配置，就能实时展示当前打开工作区的代码规模概览，非常适合日常快速核查。

具体路径如下：

1. 在VS Code的扩展市场里搜索并安装 CodeGeeX 插件。

2. 打开你的目标项目文件夹，然后点击左侧活动栏那个醒目的 CodeGeeX图标。

3. 右侧面板弹出后，找到并点击 Project Stats 标签页。在这里，代码行数和文件数量已经按文件类型分好组，以一种非常直观的方式呈现给你。

三、调用 CodeGeeX Python SDK 编写自定义统计脚本

前面两种方式已经覆盖了大部分场景，但如果你有更定制化的需求呢？比如，想把统计集成到CI/CD流水线里自动执行，或者需要按照特定模块、路径进行更细粒度的分析。这时，CodeGeeX Python SDK的强大灵活性就派上用场了。

通过调用底层的分析器，你可以完全掌控统计的维度和过滤逻辑：

1. 首先，通过 pip install codegeex 安装SDK。

2. 新建一个Python脚本，比如叫 stats.py，然后从 codegeex.analyze 模块导入所需功能。

3. 关键的一步，调用分析函数。例如，你可以这样写：analyze_project(root_path="./src", include_patterns=["*.py", "*.js"], exclude_patterns=["test_*.py"])。函数执行后会返回一个 SummaryResult 对象，里面包含了所有你需要的统计细节，直接打印或进一步处理即可。

这样一来，无论是自动化报告还是深度分析，你都能轻松搞定。