从 Chrome 浏览器导出插件（.crx）完整指南

2026/9/19大约 5 分钟

从 Chrome 浏览器导出插件（.crx）完整指南

1. 为什么要导出 Chrome 插件？

常见场景：

备份：防止插件从商店下架后无法再安装。
迁移：换电脑或换浏览器时，快速恢复同一套插件。
离线分发：把插件发给别人，对方无需访问商店即可安装。
二次开发：想基于现有插件改代码，需要先拿到它的文件。

Chrome 插件在商店里分发的格式是 .crx，本质是一个带签名的 ZIP 包。导出插件，就是想办法拿到这个 .crx，或者自己重新打包出一个。

2. 先搞清楚两个关键概念

Chrome 把已安装的插件放在一个固定目录里，每个插件用一长串 Extension ID 命名。

macOS 路径：

~/Library/Application Support/Google/Chrome/Default/Extensions/

Windows 路径：

C:\Users\你的用户名\AppData\Local\Google\Chrome\User Data\Default\Extensions

但这个目录是 Chrome 运行时使用的安装目录，不是原始源码目录。它的特点是：

目录名是插件 ID，不是插件名；
里面通常还有一层版本号文件夹（如 8.12.37.1）；
manifest.json 在版本号文件夹里，不在插件 ID 文件夹里；
商店安装的插件可能被 Chrome 处理过，直接打包不一定能正常用。

所以：“找到插件位置”和“成功导出插件”是两件事。

2.2 `.pem` 私钥文件的作用

.crx 文件是签名过的。签名流程大致如下：

用私钥对插件内容加密，生成签名；
把签名和公钥一起塞进 .crx；
Chrome 安装时用公钥验证，确认“这个插件确实来自持有对应私钥的人”。

.pem 文件的作用：

决定 Extension ID：同一个私钥，永远生成同一个 ID；
决定更新权限：发布新版本必须用同一个私钥签名，Chrome 才认为是“升级”而不是“新插件”。

如果丢了 .pem：

仍可打包出 .crx，但会被当成全新插件（新 ID）；
已安装旧版本的用户无法自动更新；
如果是离线分发，.pem 就是命根子，务必保存好。

3. 方法一：用 Chrome 自带功能打包（推荐用于自己开发的插件）

3.1 步骤

打开 Chrome，地址栏输入：
```
chrome://extensions/
```
打开右上角 开发者模式。
点击左上角 打包扩展程序。
在弹窗里填写：
- 扩展程序根目录：选择包含 manifest.json 的那一层文件夹；
- 私有密钥文件：
  - 第一次打包：留空，Chrome 会自动生成 .pem；
  - 后续更新：选择之前保存的 .pem。
点击 打包扩展程序，生成 .crx 和 .pem。

3.2 生成位置

.crx 和 .pem 默认生成在 源码文件夹的上一级目录。

3.3 命令行方式（macOS）

Chrome 可执行文件路径：

"/Applications/Google Chrome.app/Contents/MacOS/Google Chrome"

打包命令：

"/Applications/Google Chrome.app/Contents/MacOS/Google Chrome" \
  --pack-extension="/Users/你的用户名/项目/我的插件" \
  --pack-extension-key="/Users/你的用户名/项目/我的插件.pem"

第一次打包可省略 --pack-extension-key，Chrome 会自动生成 .pem。

注意：Google Chrome.app 路径里有空格，必须加引号。

4. 方法二：导出已安装的商店插件（推荐用工具）

如果你只是想 备份 / 分享 一个已经装好的商店插件，用 Chrome 自带的“打包扩展程序”经常会报错：

打包扩展程序错误：清单文件缺失或不可读取

原因就是前面说的：你选的目录层级不对，或者该目录里根本没有可读的 manifest.json。

4.1 更可靠的做法：用 CRX 提取工具

Chrome 商店里有一类专门做这件事的插件，比如 CRX Extractor/Downloader。流程通常是：

安装该工具；
打开目标插件的商店详情页；
点击工具按钮，选择下载 .crx；
保存到本地。

这种方式拿到的 .crx 是商店原始分发包，比从安装目录硬打包靠谱得多。

4.2 如果一定要从安装目录手动找

先确认目录结构：

cd "/Users/huanglian/Library/Application Support/Google/Chrome/Default/Extensions/aeblfdkhhhdcdjpifhhbdiojplfjncoa"
ls

如果看到类似 8.12.37.1 的版本号文件夹，再进去一层：

cd 8.12.37.1
ls

这时应该能看到 manifest.json。把“扩展程序根目录”指到这一层，再尝试打包。

但仍要提醒：从安装目录打包出来的 .crx，可能因为缺少原始签名或代码被处理过而无法正常使用。

5. 常见坑与排查

现象	原因	解决
`cd: string not in pwd: ...`	路径里有空格，没加引号	用引号包住整个路径，或对空格加 `\\`
“清单文件缺失或不可读取”	选到了插件 ID 层，没进到版本号层	进入版本号文件夹，确认能看到 `manifest.json`
打包出的 `.crx` 装不上	从安装目录打包，签名/结构不完整	改用 CRX 提取工具，或找原始源码
更新后变成新插件	换了 `.pem` 或丢了原私钥	始终使用同一个 `.pem`
想改代码重新打包	安装目录不是源码	找到原始源码文件夹再打包

6. 总结

自己开发的插件：用 chrome://extensions/ 的“打包扩展程序”，选含 manifest.json 的目录，第一次留空生成 .pem，之后一直用同一个 .pem。
备份/分享商店插件：优先使用 CRX 提取类工具，别硬从安装目录打包。
找插件位置：~/Library/Application Support/Google/Chrome/Default/Extensions/，每个插件以 ID 命名，里面还有版本号层。
.pem 务必保存：它决定插件身份和更新能力，丢了就只能当新插件分发。