WordPress自定义主题中budget.json文件不生效问题求助

1. 检查budget.json的位置与格式 #

Lighthouse默认会扫描网站根目录（即WordPress安装的根目录，wp-content的上级文件夹）下的budget.json，而非主题目录。若你希望放在主题目录，需要在Lighthouse运行时手动指定文件的完整URL：

• 打开Chrome DevTools的Lighthouse面板
• 展开「Settings」选项
• 在「Budgets」字段中输入主题目录下budget.json的绝对URL（例如http://your-domain.com/wp-content/themes/your-custom-theme/budget.json）

同时确保budget.json格式严格符合JSON规范，示例如下：

[
  {
    "path": "/*",
    "timings": [
      {
        "metric": "first-contentful-paint",
        "budget": 1000
      },
      {
        "metric": "largest-contentful-paint",
        "budget": 2500
      }
    ],
    "resourceSizes": [
      {
        "resourceType": "total",
        "budget": 1000
      }
    ]
  }
]

2. 修正theme.json的性能预算配置 #

WordPress的theme.json有专属的性能预算配置结构，不能直接照搬web.dev的budget.json格式，正确配置示例如下：

{
  "settings": {
    "performance": {
      "budgets": [
        {
          "name": "total",
          "type": "resource",
          "budget": 1000
        },
        {
          "name": "largest-contentful-paint",
          "type": "metric",
          "budget": 2500
        }
      ]
    }
  }
}

注意：目前WordPress对theme.json中性能预算的支持仅针对块编辑器相关资源，Lighthouse不会直接读取该配置作为性能检测的预算标准。

3. 理解Pagespeed Insights的局限性 #

Pagespeed Insights（PSI）是云端检测工具，不会读取你网站服务器上的budget.json或theme.json配置。若要在PSI中使用自定义预算，需通过Google Cloud的Lighthouse API发起检测请求时手动指定预算参数，无法通过网站内文件实现。

4. 清除缓存确保检测生效 #

本地测试时，浏览器缓存可能导致Lighthouse无法读取新的预算配置，建议：

• 使用无痕模式运行Lighthouse检测
• 手动清空浏览器缓存后重新检测

内容的提问来源于stack exchange，提问作者Phillip Dews