如何安装GitLab上的Firefox扩展？自行打包后提示损坏怎么办？

打包提示「已损坏」的核心原因 #

• 直接打包仓库源码无法使用：该扩展需要经过前端构建流程编译生成符合规范的扩展文件，原始源码不满足Firefox扩展的结构要求
• 未签名扩展无法直接安装：Firefox正式版默认禁止安装未经过Mozilla官方签名的第三方扩展，自打包的未签名包会被判定为已损坏

安装操作步骤 #

方案一：临时安装（重启浏览器后扩展自动失效，适合短期试用） #

1. 将你下载的仓库zip文件解压到本地任意目录
2. Firefox地址栏输入 about:debugging 回车进入调试页面
3. 点击左侧菜单的「此Firefox」选项
4. 找到「临时扩展」板块，点击「临时加载附加组件」按钮
5. 在弹出的文件选择窗口中，进入你刚才解压的仓库根目录，选中manifest.json文件确认即可完成安装

方案二：永久安装（长期生效） #

1. 本地提前安装好Node.js和npm运行环境
2. 打开终端进入解压后的仓库根目录，执行 npm install 安装项目所有依赖
3. 依赖安装完成后执行 npm run build:prod，构建完成后会在根目录的web-ext-artifacts文件夹下生成未签名的扩展zip包
4. 注册Mozilla开发者账号，将生成的zip包上传到Mozilla扩展开发者平台进行签名，签名完成后下载得到的xpi文件可直接双击安装到Firefox中，重启浏览器也不会失效

如果你使用的是Firefox开发者版/ nightly版，可跳过签名步骤：打开about:config页面，搜索xpinstall.signatures.required将值修改为false，即可直接将构建生成的zip包拖入Firefox完成安装，该操作不推荐普通用户使用。

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