首先实现代码气味检测与评分系统，通过 vscode 插件监听文件变化，利用 AST 分析识别过长函数、过多参数等常见代码问题，结合严重性加权扣分生成 0 -100 质量分，并在编辑器中标记问题、展示趋势，支持配置、修复建议和 CI/CD 集成，提升代码可维护性与团队协作效率。
代码质量直接影响项目的可维护性和团队协作效率。在日常开发中，借助 VSCode 插件实现代码气味（Code Smell）检测与自动评分，能帮助开发者及时发现问题、优化结构。以下是构建一个轻量但实用的代码气味检测引擎与质量评分系统的实现思路与步骤。
代码气味识别核心规则
代码气味是代码中潜在设计问题的征兆，常见的包括：
- 过长函数：单个函数超过一定行数（如 50 行），难以理解和测试
- 过多参数：函数参数超过 4 个，增加调用复杂度
- 重复代码块：相同或高度相似的代码片段出现在多个位置
- 过大类：类的行数或方法数量超出合理范围
- 深层嵌套 ：if/for 等嵌套层级超过 3 层，影响可读性
这些规则可通过静态分析 AST（抽象语法树）来检测。使用 Babel 或 typescript Compiler API 解析 javaScript/TypeScript 代码，提取结构信息进行判断。
VSCode 插件 架构 实现
基于 VSCode Extension API 构建插件，主要模块包括：
- 文件监听器：通过
workspace.onDidSaveTextDocument或实时编辑监听触发分析 - 分析引擎：加载解析器，对当前文件或项目批量扫描
- 诊断报告器：使用
vscode.Diagnostic在编辑器中标记问题位置 - 评分计算器：根据问题数量和严重程度生成质量分（如 0 -100）
例如，当检测到一个函数超过 60 行，系统创建一条 Warning 级别的诊断信息，并在状态栏显示当前文件得分为 72。
质量评分模型设计
评分不应只看问题数量，需结合严重性与类型加权：
- 每个问题按严重等级扣分：Minor（-1）、Major（-3）、Critical（-8）
- 重复代码和过大型类视为高权重问题
- 基础分设为 100，最终得分 = max(0, 100 – 总扣分）
- 支持按文件、目录或整个项目聚合评分
结果可通过侧边栏 webview 展示趋势图，帮助开发者追踪改进情况。
扩展与集成建议
为进一步提升实用性：
- 支持自定义规则配置（通过
.codereviewrc文件） - 集成 ESLint、Prettier 等 工具 输出，统一问题视图
- 提供快速修复建议，如“提取方法”自动 重构 长函数
- 输出 jsON 报告，便于 CI/CD 流程中做质量门禁
基本上就这些。不复杂但容易忽略的是用户体验细节，比如诊断延迟避免卡顿、错误定位精准、提示语清晰。一个好用的质量 工具，不只是发现问題，更要让人愿意改。
