Lighthouse提供五种检测方式:Chrome DevTools、官方扩展、CLI命令行、Node.js模块集成及报告导出复用,覆盖单页审计、批量测试与自动化场景。

如果您希望客观评估一个网页在性能、可访问性、SEO、最佳实践和PWA等方面的综合质量,Lighthouse可直接提供结构化评分与诊断依据。以下是执行检测的具体路径:
一、通过Chrome开发者工具运行Lighthouse
此方式利用浏览器原生集成能力,无需额外安装,适合快速单页审计,结果实时渲染于DevTools界面内。
1、在Chrome中打开目标网页URL。
2、按下F12或右键页面空白处选择“检查”以调出开发者工具。
3、点击顶部导航栏中的Lighthouse标签页。
4、确认左侧面板中显示的URL为当前页面地址,勾选全部审核类别(Performance、Accessibility、Best Practices、SEO、PWA)。
5、在“设备”选项中选择桌面或移动设备,如需模拟弱网环境,可在“网络节流”中设为Slow 4G。
6、点击分析页面加载情况按钮,等待约30–60秒完成自动审计。
7、报告生成后,滚动查看各维度得分及对应问题项,点击具体条目可展开详细说明与官方优化指引。
二、使用Chrome官方扩展程序启动Lighthouse
该方式为不熟悉开发者工具的用户提供了图形化入口,操作更直观,且支持一键刷新后立即审计。
1、访问Chrome网上应用店,搜索并安装由Google官方发布的Lighthouse扩展程序。
2、安装完成后,在Chrome右上角工具栏找到灯塔图标(?)。
3、确保已打开待测网页,点击灯塔图标,弹出配置窗口。
4、保持默认设置,或手动勾选所需审计类型,点击Generate report。
5、等待数秒,系统将自动跳转至新标签页,展示完整HTML格式报告,含可视化图表与可折叠建议项。
三、通过命令行工具(CLI)批量运行Lighthouse
适用于需要自动化、持续集成或跨多URL批量测试的场景,支持参数定制与结构化输出,便于脚本调用与数据归档。
1、确认本地已安装Node.js 8.9+及npm包管理器。
2、在终端中执行命令:npm install -g lighthouse完成全局安装。
3、运行审计指令,例如:lighthouse https://example.com --output html --output-path ./report.html --view。
4、其中--view参数将自动在默认浏览器中打开生成的HTML报告;--output json可输出JSON格式供后续解析。
5、如需测试移动端效果,添加参数:--emulated-form-factor=mobile --throttling.rttMs=150。
四、使用Node.js模块在代码中集成Lighthouse
该方式允许将Lighthouse作为依赖引入项目,实现自定义触发逻辑、动态URL注入、条件化审计策略等高级控制。
1、在项目目录中执行:npm install lighthouse进行本地安装。
2、创建JavaScript文件(如run-lh.js),引入模块并配置运行参数:
3、调用lighthouse()函数传入URL、端口、输出格式及配置对象,返回Promise。
4、通过.then()处理生成的报告路径或JSON结果,支持写入文件、发送至监控服务或触发告警。
5、运行命令:node run-lh.js,即可执行嵌入式审计流程。
五、导出与复用Lighthouse报告
审计完成后,原始报告可持久化保存,便于版本比对、团队评审或合规存档,所有输出均基于标准格式,无平台绑定限制。
1、在开发者工具中生成报告后,点击右上角⋮菜单,选择Export report。
2、支持导出为HTML或JSON格式,HTML报告可离线打开,JSON可用于程序解析。
3、若使用CLI,可通过--output-path指定绝对路径,例如:--output-path /reports/site-v1.html。
4、多个报告可统一存放于本地目录,按日期或URL命名,用于人工横向对比性能趋势。
5、在HTML报告页面中,点击任意指标条目右侧的ℹ️图标,可查看该指标定义、计算逻辑与修复路径。

















