Chrome、Firefox 与 Edge 的浏览器启动 flag

​

Firefox 有 firefox://flags 吗？

• 用 browserFlags 配置 Extension.js 传给浏览器二进制的启动 flag。
• 用 Firefox preferences 配置原本会写在 about:config 中的、可复现的 Gecko 运行时行为。

​

模板示例

​

new-browser-flags

npx extension@latest create my-extension --template=new-browser-flags

pnpx extension@latest create my-extension --template=new-browser-flags

yarn dlx extension@latest create my-extension --template=new-browser-flags

bunx extension@latest create my-extension --template=new-browser-flags

bunx extension@latest create my-extension --template=new-browser-flags

​

工作原理

• browser.<target>.browserFlags
• commands.dev|start|preview.browserFlags
• 可选的 excludeBrowserFlags，用于移除默认 flag 或用户自定义的 flag（具体行为取决于目标是 Chromium 还是 Firefox）。

​

flag 能力

​

配置示例

export default {
  browser: {
    chrome: {
      browserFlags: ["--disable-web-security", "--auto-open-devtools-for-tabs"],
      excludeBrowserFlags: ["--mute-audio"],
    },
    firefox: {
      browserFlags: ["--devtools", "--new-instance"],
      excludeBrowserFlags: ["--devtools"],
    },
  },
};

​

Chromium 与 Firefox 行为对比

• Chromium 家族（chrome、edge、chromium、chromium-based）
  • 从一组内部默认 flag 出发，然后追加你的 browserFlags。
  • excludeBrowserFlags 会移除匹配的默认 flag（按精确匹配过滤）。
  • Extension.js 自己管理 --load-extension=...，并会从用户传入的 flag 中将其过滤掉。
• Firefox/Gecko 家族（firefox、gecko-based / firefox-based）
  • 使用用户传入的 browserFlags（没有像 Chromium 那样的大量默认 flag）。
  • excludeBrowserFlags 按前缀匹配移除用户 flag。

​

Chromium 默认 flag

​

支持的目标与参考资料

• --chromium-binary=...
• --gecko-binary=...

​

最佳实践

• 只加必要的 flag：尽量精简 flag 列表，避免不稳定或不可移植的配置。
• 优先使用 excludeBrowserFlags，而不是整体替换默认值：只移除与你的工作流冲突的部分。
• 不要手动传入 --load-extension：Extension.js 会在内部管理扩展加载相关的 flag。
• 按浏览器家族分别验证：在 Chromium 上可用的 flag，在 Firefox 上可能无效或被忽略。

​

下一步

• 进一步了解 浏览器 preferences。
• 进一步了解 浏览器 profile。
• 在 可用浏览器 中选择目标。
• 通过 extension.config.* 串联 flag 配置。
• 第一次接触扩展工具链？先从 浏览器扩展框架 概览开始。