Skip to main content

1 / 4概念

Code Quality

代码质量工具把“可维护性”拆成可重复检查的信号:格式、规则违规、类型错误、重复度、覆盖率和安全热点。判断标准不是告警数量,而是哪些告警真的能阻止缺陷进入主干。

1 概念​

1.1 一句话定义​

代码质量是一组可度量的属性——正确性、可读性、可维护性、安全性和性能——以及用来守住这些属性的静态检查、格式化和质量门禁。工具只提供信号,门禁才决定信号是否阻断合并。

1.2 它解决什么问题​

  • 格式争论消耗评审时间:缩进、引号、换行本可以自动统一。
  • 低级缺陷重复出现:未处理的 Promise、悬空变量、危险的正则。
  • 质量随版本漂移:没有门禁时,规则会逐渐被忽略或关闭。

没有这些工具,评审靠个人习惯,缺陷靠线上发现,债务靠感觉。

1.3 不属于本页的内容​

主题去哪
打包、测试运行器与类型检查命令JavaScript / TypeScript Toolchain
流水线阶段、缓存与门禁执行CI/CD
依赖漏洞、SBOM 与签名Supply Chain Security
代码评审的沟通与设计取舍Code Review / Architecture

1.4 关键术语​

术语含义容易混淆的点
规则(rule)对 AST 的一次断言不是格式化偏好
严重级别off/warn/error 或 blocker/critical决定是否阻断
自动修复工具直接改写源码不是所有规则都安全
技术债为短期交付留下的可量化维护成本不是“代码丑”
质量门禁进入下一阶段的条件集合不是报告本身
误报规则报告了实际不存在的问题不是“我不想改”
基线存量问题的冻结快照不是永久豁免