修改Firefox源码：如何永久添加自定义扩展并集成至编译版本

1. 先搞定扩展的基础配置 #

• 确保你的自定义扩展manifest.json里已经设置好browser_specific_settings.gecko.id（比如my-custom-ext@your-brand.com），这个ID是后续配置的核心，必须准确。
• 扩展可以是未打包的源码目录，也可以是打包好的.xpi文件，用源码目录更方便调试。

2. 把扩展放到正确的目录里 #

• 别再用browser/extension了，换成Firefox源码树里的browser/extensions/（注意是复数）。
• 如果是源码目录，直接用你刚才设置的扩展ID当目录名，避免和其他内置扩展冲突。

3. 给扩展加构建规则（针对源码目录） #

• 在你的扩展目录里新建一个moz.build文件，把下面的内容放进去，按需调整文件列表：

# 声明需要打包的扩展文件
EXPORTS.mozilla.extensions += [
    "manifest.json",
    "background.js",
    "content-script.js",
    # 把你扩展里的其他必要文件都加上
]

# 如果扩展用到了chrome.manifest，加上这行
BROWSER_CHROME_MANIFESTS += ["chrome.manifest"]

4. 修改编译配置文件mozconfig #

• 打开你的mozconfig，添加下面这行，把默认扩展和你的自定义扩展一起启用：

ac_add_options --enable-extensions=default,my-custom-ext@your-brand.com

记得把my-custom-ext@your-brand.com替换成你扩展的实际ID。

5. 重新编译Firefox #

• 执行常规的编译命令./mach build，构建系统会自动把你的扩展集成到最终的浏览器包中。

排查小技巧 #

• 如果扩展没被集成，先检查mozconfig里的ID和manifest.json里的是不是完全一致，多一个符号都不行。
• 确认browser/extensions/下的扩展目录名或.xpi文件名没问题，源码目录必须有moz.build文件。
• 看编译日志找问题：./mach build 2>&1 | grep 你的扩展ID，能快速定位构建错误。

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