AI Agent / 系统课时

引入格式化与静态检查

引入格式化与静态检查

格式化与静态检查可以在代码运行前发现大量质量问题,包括风格不一致、类型错误、潜在缺陷和不符合规范的写法。本节将建立基础质量门禁,让 AI 生成的代码更容易维护和协作。

学习目标

  • 理解格式化、类型检查和静态扫描的职责区别。
  • 掌握将质量检查加入开发流程的方法。
  • 能够配置自动检查命令并验证检查结果。

格式化统一代码风格

格式化工具通过固定规则自动调整代码布局,例如缩进、换行、引号和空格。它不判断业务逻辑是否正确,但可以减少团队协作中的无意义修改。

在 Vibe Coding 工作流中,格式化尤其重要,因为 AI 生成代码可能来自不同风格来源。统一格式可以让开发者更关注逻辑,而不是手动调整代码样式。

以 JavaScript 项目为例,可以使用 Prettier 配置格式规则:

json
{
  "semi": true,
  "singleQuote": true,
  "printWidth": 100
}

配置完成后执行格式化命令:

bash
npx prettier --write src

预期输出

text
src/app.js 120ms
src/utils.js 35ms
Code formatted successfully.

静态检查发现潜在问题

静态检查通过分析源码发现可能的问题,例如未使用变量、危险写法、复杂度过高或类型错误。它不会替代测试,而是在开发早期提供快速反馈。常见质量工具职责如下:

类型 主要作用
格式化工具 统一代码表现形式
Linter 发现代码规范和潜在错误
类型检查 验证数据结构和调用关系
安全扫描 发现依赖和代码风险

例如使用 ESLint 检查项目代码:

bash
npx eslint src

预期输出

text
✔ 0 problems found

构建质量门禁流程

单独执行检查容易被遗漏,因此应将格式化、静态检查和测试组合成固定流程。一个简单的 npm 配置示例:

json
{
  "scripts": {
    "format": "prettier --write src",
    "lint": "eslint src",
    "test": "jest",
    "check": "npm run lint && npm run test"
  }
}

执行质量检查:

bash
npm run check

预期输出

text
✔ eslint completed
✔ jest completed
✔ quality check passed

质量门禁的价值在于提前阻止低质量代码进入主分支。对于 AI 辅助开发,检查结果还能帮助开发者快速判断生成代码是否符合项目要求。

处理检查失败问题

当检查失败时,不应直接关闭规则或跳过验证,而应根据问题类型处理。常见处理方式包括:

  • 格式问题:运行自动格式化工具修复。
  • 类型问题:检查数据结构和接口定义。
  • 规则问题:确认规则是否合理,再调整代码。
  • 误报问题:补充配置或添加明确例外。

高质量项目通常会把检查命令接入提交前钩子或持续集成流程,使每次修改都经过统一验证。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

引入格式化与静态检查

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通