Skip to content

约 3 分钟阅读

前端质量工具链:格式、规则、类型与行为 ​

商品单价从元改为分,忘记修改展示函数后,页面可能显示“¥1290.00”。这段代码完全可以格式正确、类型正确、构建成功。质量检查的价值在于各自覆盖不同错误,而不是把一个绿色结果当成所有行为都正确。

四类检查独立汇入发布门禁

同一个错误由哪层发现 ​

变化或错误合适的检查仍覆盖不到
缩进、换行不一致Formatter金额单位是否正确
使用未定义变量、违反Hook规则已启用相应规则的Lint所有用户流程
number参数传入string类型检查远端JSON真实结构
1290分应显示¥12.90行为测试未编写的需求与环境
入口引用或构建插件失败生产构建用户点击后的完整结果

Lint 只能执行已配置的规则;可访问性插件也不等于真实键盘和读屏验收。类型化 Lint 可以利用类型信息,仍不替代完整类型检查。不要让 Formatter 和 Lint 在同一格式规则上反复互相修改。

先给业务规则一个可验证入口 ​

price.js 只接收非负安全整数分,拒绝模糊单位。这里采用明确的人民币前缀和两位小数展示规则。

js
// price.js
export function formatPrice(priceCents) {
  if (!Number.isSafeInteger(priceCents) || priceCents < 0) {
    throw new TypeError("金额必须是非负安全整数分");
  }
  return "¥" + (priceCents / 100).toFixed(2);
}

配套 Node 内置测试不依赖浏览器。在 package.json 已设置 type: module 的目录中保存为 price.test.js,执行 node --test price.test.js。

js
import test from "node:test";
import assert from "node:assert/strict";
import { formatPrice } from "./price.js";

test("按分显示金额并保留两位小数", () => {
  assert.equal(formatPrice(1290), "¥12.90");
  assert.equal(formatPrice(0), "¥0.00");
});
test("拒绝不符合单位合同的输入", () => {
  for (const value of [-1, 12.5, "1290", NaN]) {
    assert.throws(() => formatPrice(value), TypeError);
  }
});

若接口的字符串金额在进入函数前被错误转换,测试也可能漏掉。因此还应在接口适配层覆盖字段合同,在组件层覆盖展示结果。高覆盖率只说明被执行的代码比例,不证明断言正确或需求完备。

用显式脚本连接检查 ​

下面是已安装并配置 Prettier、ESLint、TypeScript 的普通 JS/TS 项目脚本片段,测试仍使用上面的 Node 文件。Vue SFC 等项目要替换相应类型检查入口。

json
{
  "scripts": {
    "format:check": "prettier --check src",
    "format": "prettier --write src",
    "lint": "eslint src --max-warnings 0",
    "typecheck": "tsc --noEmit",
    "test:unit": "node --test price.test.js",
    "build": "vite build",
    "check": "npm run format:check && npm run lint && npm run typecheck && npm run test:unit && npm run build"
  }
}

这段串行入口使失败立即停止;CI 也可以把互不依赖的检查并行运行,发布任务等待全部通过。检查范围、忽略文件和退出码必须明确。--max-warnings 0 是此例选择的门禁策略,不是 ESLint 默认行为。

本地用自动修复提升效率,CI 用只检查模式暴露未提交变更,避免流水线悄悄修改源码却发布另一份内容。测试命令在 CI 中应运行一次后退出,不能用默认 watch 模式让任务一直等待。

失败后修哪一层 ​

格式失败先确认使用的是项目配置与版本,再运行对应格式命令。Lint 失败先看规则含义和触发代码,不能批量禁用。类型失败看真实输入与边界合同,避免用 any 或断言掩盖。行为失败则固定输入,检查实际输出、异常和异步完成条件。

--fix 只能应用工具能够自动推导的修改,仍需查看 diff。依赖安全扫描是另一类证据:发现漏洞后需要结合使用路径和影响范围处理,既不能忽略,也不能用“扫描无告警”证明完全安全。

在本地与 CI 保持同一合同 ​

CI 从已提交锁文件安装固定工具,在干净工作区运行相同入口,保存失败日志和必要的截图。开发者本地 hook 可以跳过或未安装,所以最终门禁应由受控 CI 执行。

一次有效的验收可以故意把金额除数从100改成1:行为测试应失败;再加入类型不匹配和格式变更,确认对应检查分别失败。恢复后全部通过,才能证明检查确实运行且能发现这类回归。组件、集成与端到端测试见 测试分层。

别急,先让缓存热一下。