GoogleChrome/lighthouse

项目介绍

Lighthouse 用本地 Chrome 打开页面，采集性能跟踪和网络数据，生成性能、可访问性、最佳实践和 SEO 四类报告。它面向需要可重复测量网页表现的开发者和性能工程师，而不是凭个人感受判断快慢。

使用入口按控制粒度区分：Chrome DevTools 中的 Lighthouse 面板、Chrome 扩展、用于脚本化或批量运行 Node CLI，以及在自有代码中调用的 Node 模块。报告可输出 HTML、JSON 或 CSV；JSON 报告可拖入在线 Lighthouse Viewer 查看和分享。

快速使用

单次检查：安装 Chrome，打开 DevTools，选择 Lighthouse 面板，点击 Generate report（DevTools 用法）。

需要配置或自动化时用 Node CLI，要求 Node 22（LTS）或更高版本：

npm install -g lighthouse
lighthouse https://example.com/ --view

命令会在 Chrome 中审计该页面并生成 HTML 报告，--view 用于完成后自动打开。要机器可读的结果，可用 --output json --output-path=./report.json；指定 HTML 文件则用 --output html --output-path ./report.html（CLI 选项与示例）。

审计多个地址时，可传多个 URL，或用 --url-file 读取按行分隔的列表：

lighthouse --url-file=./urls.txt --output-path=./reports

输出目录必须已经存在（输出示例）。

配置与运行方式

CLI 参数可以限定审计类别（--only-categories=performance,seo）、选择 --preset=desktop 等预设、调整节流和 Chrome 启动参数。--gather-mode（-G）把浏览器采集的产物保存到磁盘，--audit-mode（-A）基于已存产物重新审计，-GA 两者都执行；这样不用反复操作浏览器也能重跑或调试审计（生命周期示例）。

自定义审计、插件、登录后页面和 CI 性能预算等场景，仓库提供了配置文档和示例配方，包括插件示例与自定义审计示例。用代码调用时见以编程方式使用 Lighthouse。

使用约束

• Node CLI 需要 Node 22（LTS）或更新版本；运行时会驱动本机 Chrome 或 Chromium，用 CHROME_PATH 指定二进制时要求 Chromium 66.0 或更高（CLI 说明）。
• 分数依赖运行环境。 默认模拟慢速 4G 并对 CPU 降速，官方 FAQ 解释了为什么本地感觉很快的页面分数仍可能偏低（节流说明）。即使代码没变，结果也会波动，文档建议在一致环境中多次运行（波动指南）。
• 数据留在本地。 FAQ 说明报告不会发送到远程服务器；CLI 首次运行会询问是否匿名上报错误，拒绝不影响使用（错误上报说明）。
• 默认审计的是公开 URL，不处理登录流程。 测试登录后页面需要按文档中的认证页面指引单独配置。

HotRepo 点评

Lighthouse 是长期维护、使用面广的 Chrome 开发者工具，采用 Apache-2.0 许可证，并配有较大规模的测试套件。2026-11-14 的 JavaScript 语言日榜快照记录了 31,079 个 Star、当日新增 21 个，当天最好名次为第 7。2021 年 Lighthouse v8 相关的 HN 讨论集中在新的 CLS 指标和一个 CSP 相关评分边界问题上，用户报告后维护者确认会修复（讨论与 issue）。对读者来说，评分规则会随版本演进，偶尔也会因为审计工具自身的注入内容影响页面得分，遇到意外结果时应核对具体审计项和版本。