lighthouse-ci评分含义解析：Cumulative Layout Shift阈值疑问

• 核心区别：CLS原始数值 vs Lighthouse评分
  Lighthouse里的Cumulative Layout Shift有两个关键数值：

  • 原始CLS值：这是实际测量的布局偏移量，文档中说≤0.1属于"良好"（Good）等级，这个是真实的性能指标数值。
  • Lighthouse评分：系统会把原始指标转换成0-100分的评分（对应0-1的小数形式），比如原始CLS≤0.1时，对应的评分就是90分（即0.9）。

• LHCI默认断言用的是评分而非原始值
  你看到的CircleCI里断言失败提示预期评分>=0.9，实际为0.89，这里的0.9是Lighthouse对CLS指标的评分（90分），本质对应原始CLS值刚好卡在0.1的临界线附近（你的实际原始CLS略高于0.1，所以评分降到了89分）。默认配置下，LHCI的断言规则是基于指标的0-1评分来设置的，而非原始数值。

• 如何改成基于原始CLS值的断言
  如果想直接用原始数值（≤0.1）来做断言，可以修改lighthouserc.json的assert配置，自定义断言规则：

  {
    "ci": {
      "assert": {
        "assertions": {
          "cumulative-layout-shift": ["error", { "maxNumericValue": 0.1, "aggregationMethod": "median" }]
        }
      }
    }
  }
  

  这样配置后，断言会直接检查原始CLS的中位数是否≤0.1，和Lighthouse文档里的良好标准直接对应。

内容的提问来源于stack exchange，提问作者And Finally