执行命令(windows下)
lighthouse https://example.com --form-factor=mobile --only-categories=performance --locale=zh-CN --output=html --output-path=mobile-performance-report.html --chrome-flags=--headless --no-sandbox --view |
1️⃣ 主体命令 + 测试目标
| 参数 | 值 | 作用 |
|---|---|---|
lighthouse | — | 调用全局安装的 Lighthouse CLI(你之前npm install -g lighthouse装的那个) |
https://example.com | — | 要测试的页面 URL,Lighthouse 会启动 Chrome 真实访问它 |
📌
example.com是 IANA 保留的官方示例域名,啥人都能访问,常用来做测试。
2️⃣ 测试环境配置(控制"怎么测")
| 参数 | 作用 |
|---|---|
--form-factor=mobile | 模拟移动端(窄屏 + 4G + 4× CPU 慢化)。这也是默认值,显式写出来更清晰 |
--chrome-flags=--headless | 让 Chrome无头运行(不弹窗口,纯后台跑)。服务器/CI 环境必备 |
--no-sandbox | 关掉 Chrome 沙箱。在 Windows 上跑 headless 经常需要这个,不然启动会失败 |
⚠️
--chrome-flags后面跟的是要传给 Chrome 的原生参数,可叠加,比如--chrome-flags=--headless --no-sandbox(注意分隔是空格,但实际 CLI 会把整串当作原始字符串)。
3️⃣ 测试范围(控制"测什么")
| 参数 | 作用 |
|---|---|
--only-categories=performance | 只跑性能类审计。跳过可访问性、SEO、最佳实践等。报告更小、跑得更快 |
可用类别:performance/accessibility/best-practices/seo(多个用逗号分隔)。
4️⃣ 报告输出(控制"结果怎么给")
| 参数 | 作用 |
|---|---|
--locale=zh-CN | 报告界面汉化(默认英文) |
--output=html | 输出格式为 HTML(可同时给多个:--output=html --output=json) |
--output-path=mobile-performance-report.html | 报告保存到当前目录的mobile-performance-report.html |
--view | 测试完成后自动用默认浏览器打开报告,省去手动双击 |