Firefox 与 Gecko 运行时 preferences 配置

​

工作原理

• browser.<target>.preferences
• commands.dev|start|preview.preferences

​

preferences 能力

​

Firefox 与 Gecko-based 行为

​

配置示例

export default {
  browser: {
    firefox: {
      preferences: {
        "browser.startup.homepage": "https://developer.mozilla.org",
        "devtools.theme": "dark",
        "dom.webnotifications.enabled": false,
      },
    },
  },
};

• 开发与运行时行为所需的内部基线 preferences。
• 你自定义的 preferences 值（同名键以你的值为准）。

​

Chromium 家族行为

• browserFlags
• excludeBrowserFlags
• profile / persistProfile

​

深色模式默认值

• Chromium 家族：深色模式启动 flag
• Firefox/Gecko 家族：深色模式 preferences 键（用于 UI 与内容的配色方案）

​

接口示例

export default {
  commands: {
    dev: {
      browser: "firefox",
      preferences: {
        "devtools.theme": "dark",
      },
    },
  },
};

​

自定义 profile 示例

export default {
  browser: {
    firefox: {
      profile: "path/to/custom-profile",
      preferences: {
        "browser.startup.homepage": "https://example.com",
      },
    },
  },
};

​

更详细的 preferences 参考

​

最佳实践

• 优先使用浏览器作用域的 preferences：把 Firefox/Gecko 的 preferences 键放在按浏览器目标划分的配置块中。
• 临时实验放进命令覆盖：短期使用的 preferences 调整放在 commands.dev 里。
• 保持 profile 隔离：用不同的 profile 实现可复现的调试。
• Chromium 调优请用 flag：在 Chromium 家族目标上，把 flag 当作主要的配置入口。

​

下一步

• 进一步了解 浏览器 flag。
• 进一步了解 浏览器 profile。