build 会以生产模式编译你的扩展，并将输出写入 dist/<browser>。
对于 monorepo / 子模块项目，关于配置期的环境变量解析（优先项目根，再退回工作区根），请参见 环境变量。
什么时候使用 build
- 为 Chrome Web Store、Edge Add-ons 或 Firefox Add-ons 准备扩展包。
- 在持续集成（CI）中跑出可复现的生产产物。
- 在提交前验证生产打包的输出以及各浏览器目标之间的差异。
build 命令的能力
用法
build 输出
运行build 后，Extension.js 会为所选浏览器目标生成优化过的文件。输出位于 dist/，每个目标一个子目录。每个目录都包含打包后的 JavaScript、CSS、HTML 和必要的运行时资源。
对于 TypeScript 项目，
build 也会重新生成 extension-env.d.ts
环境类型声明（与 dev 写出的是同一个文件），
所以无论你之前是否运行过 dev，CI 上的 tsc --noEmit 都能保持干净。 纯
JavaScript 项目会跳过这一步。浏览器目标矩阵
引擎目标对 build 意味着什么
build 不会启动浏览器，因此引擎目标在这里并不指向某个二进制——但它们仍会产出一个独立的产物，而不是具名目标构建的改名副本：
- 独立的输出目录。
--browser=chromium-based输出到dist/chromium-based，与dev、preview、start在该目标下使用的目录一致——用自定义 Chromium 二进制开发的项目，构建产物路径完全对应。 - 独立的 env 解析。
.env.chromium-based与.env.chromium-based.production优先于家族级的.env.chromium/.env.chrome/.env.edge，且打包后的代码中EXTENSION_BROWSER === "chromium-based"——代码与配置可以据此区分“通用 Chromium”与某个具体商店构建。 - 独立的 manifest 前缀。
manifest.json中的chromium-based:键会作为该目标最具体的匹配生效，叠加在家族级chrome:/chromium:/edge:键之上。
gecko-based 相对 firefox 的行为完全相同。构建不需要浏览器二进制——--chromium-binary/--gecko-binary 只对会启动浏览器的命令有意义。
参数与 flag
--author 与 --author-mode 是 --debug 的隐藏、已废弃别名。
Safari flag
这些 flag 只适用于safari 与 webkit-based 目标。把其中任何一个和别的目标一起传入都会以错误退出，所以拼错时不会静默地什么都不做。
Safari 打包会在构建前跑一次预检。在非 macOS 主机上，
build 会告警并跳过 Safari 打包步骤，但仍然会编译 bundle。在 macOS 上，如果 Xcode 缺失或损坏，则是致命错误。
共享的全局选项
也支持 全局 flag。模式覆盖
--mode 会覆盖构建的打包器模式以及 NODE_ENV。可选值为 development、production 或 none。当你需要为 staging 或调试产出非生产 bundle 时（类似 Vite / webpack 的工作流），可以用它来对齐行为。
production。
zip 行为
每个 zip 都落在它自己的
dist/<browser> 目录里，与解包后的输出放在一起。不带 --zip-filename 时，名称由 manifest 的 name 转小写、去掉 a-z0-9 与空格以外的所有字符、把剩下的空格换成连字符，再接上 manifest 的 version 得到。一个名为 My Extension+、版本为 1.0.0 的 manifest 会打包成 dist/chrome/my-extension-1.0.0.zip。因为名称被改写过，请从构建输出里读取实际路径，而不要用 manifest 名称自行拼接。
示例
带 zip 输出与自定义文件名的构建
my-extension.zip。
带 polyfill 支持的构建
构建源代码与产物 zip
成功的构建会打印什么
在资源汇总之后，一次成功的构建会打印输出目录和它的体积， 然后是一个可以用来把构建交给别人评审的链接：compiled with warnings 而不是 compiled in。
不要用这些文案来给 CI 把关。它是写给人看的，会随版本变化。
请使用退出码，或者下面的 --output json，那才是受支持的机器契约。
用 --output json 输出机器可读结果
--output json 会在 stdout 上打印一个 schema-1 信封，并把给人看的构建日志转到 stderr。stdout 始终可以作为一份 JSON 文档解析。
- 成功的运行会打印一个
status: "built"帧。它的value携带构建出的浏览器、解析出的模式，以及每个浏览器一份汇总。每份汇总记录输出路径、资源总量、警告文本，以及相关时的 Safari 应用标识。 - 失败的构建会在进程以
1退出前打印一个ok: false帧，其status: "build-failed"、error.code: "E_COMPILE"。
dist/extension-js/<browser>/build-summary.json。通过 shell 调用 extension build 的脚本可以从那里读取结构化的警告。请检查文件的修改时间，避免读到过期文件。
最佳实践
- 查看构建日志： 每次构建后检查日志，看是否有警告与缺失资源。
- 优化你的 manifest： 让
manifest.json与每个目标浏览器都兼容。 - 有意识地命名产物： 用
--zip-filename让 CI 产物命名保持稳定。 - 逐个目标验证输出： 发布前检查每一个
dist/<browser>目录。之后的一次dev会用带开发插桩的构建覆盖同一个目录，那个构建会额外加上scripting、tabs、management、storage等权限，以及针对<all_urls>的host_permissions和宽泛的 web-accessible resources。打包或发布前请重新运行一次build。
下一步
- 把这个构建通过一个链接交给别人评审，参见 Share an unpublished build for review。
- 把产物提交到浏览器商店，参见 extension.dev 发布文档。
- 用
publish为项目在 extension.dev 上获取一个可分享的 URL。 - 用
preview运行已有的构建产物。 - 用
start一条命令构建并启动。 - 在
extension.config.js中集中配置共享默认值。 - 在 环境变量 中查看配置期的 env 加载行为。
- 在 可用浏览器 中查看支持的目标。