兼容性指南
Manifest V2 与 Manifest V3:每个 Chrome 版本能装什么
从 Chrome 87 到 156,按版本顺序看清两种扩展格式何时能用、何时失效,以及下载旧版本前该注意什么。
Manifest V2 与 Manifest V3 是什么
- Manifest V2
- Chrome 扩展的旧格式。扩展以常驻的后台页面运行,可以直接拦截和修改网络请求。Chrome 正在逐步停用它。
- Manifest V3
- Chrome 扩展的现行格式,Chrome 88 起支持。后台改为按需启动的 service worker,网络过滤改用声明式规则(declarativeNetRequest),权限也更严格。
每个扩展的 manifest.json 都写明自己使用哪种格式;下文简称 MV2 和 MV3。
Manifest V2 彻底退出
浏览器里已不再包含任何 MV2 开关或策略,所有方法都被拒绝。MV3 没有上限:从 88 到我们测试的 156 一直正常运行,真正的风险只剩“浏览器太旧”。
156实测最新版:MV2 全部拒绝,MV3 正常。实测151命令行开关全部失效。实测
MV2 拒绝安装
普通用户已无法使用 MV2:安装被拒绝,也不能重新启用,开发者模式和“加载已解压的扩展程序”都无济于事。只有企业策略(到 138)和命令行开关(到 150)还能临时保留。
150命令行开关最后一个有效版本(还需额外重新启用)。实测139企业策略 ExtensionManifestV2Availability 被移除。实测137默认拒绝安装 MV2,无法重新启用。实测
MV2 默认被停用
MV2 扩展仍能安装,但装好后处于停用状态(unsupportedManifestVersion)。用户可以在 chrome://extensions 手动重新启用,启用后照常运行。Google 从 2024 年 10 月起分批推送,部分用户晚些才遇到。
2024年10月Google 开始向用户分批停用。官方文档129代码默认值开始停用 MV2。实测
两种格式并存,MV3 能力陆续补齐
MV2 和 MV3 都能正常使用,这是兼容性最宽松的一段。MV3 的新接口一个个加入:用到它们却没有声明最低版本的扩展,在旧浏览器里能装上,但相关功能会失效。
127–128MV2 仍正常运行;Chrome 开始在扩展页提示 MV2 即将停用。实测120userScripts 权限可用(还需用户在扩展页开启)。官方文档114sidePanel 侧边栏可用。实测109offscreen 接口可用;更早版本能装能跑,但调用失败。实测2022年1月Chrome 应用商店不再接受新的 MV2 扩展(商店政策,不影响浏览器)。商店政策96declarativeNetRequestWithHostAccess 权限可用。官方文档92ES 模块后台开始运行。实测
MV3 进入稳定版
Chrome 88 起 MV3 扩展可以安装并运行。但写成 ES 模块("type": "module")的后台在 92 之前仍然装上却不运行。
88–91模块后台在列表里显示有 service worker,实际从不启动。实测88MV3 基础支持:安装、启用、后台运行全部通过。实测
只有 MV2 的年代
Manifest V2 是唯一的正式格式。MV3 扩展在稳定版里能装上、看起来已启用,但后台脚本从不运行——这是最难察觉的失败。
87稳定版 87 最高只认 manifest_version 2;service_worker 后台仅限 Dev 渠道。源码核对
Chrome 137 起 MV2 拒绝安装,普通用户没有任何绕过办法。
Chrome 129–136 会自动停用 MV2 扩展,但用户仍可在扩展页手动重新启用。
MV3 需要 Chrome 88 或更高版本,更旧的浏览器会“装上但不运行”。
浏览器低于清单中的 minimum_chrome_version 时,拖入扩展页、加载已解压扩展和企业策略安装都会被拒绝。
下载旧版本前
- 先看 Manifest 版本:Chrome 137 及以上只选 MV3。
- 再看最低版本:低于声明值会被拒绝安装。
- 浏览器太旧时,选与之兼容的最新版本,或先升级浏览器。
测试方法与局限
2026 年 10 月 18 日在 Linux 上用 Chrome for Testing 113–156 与 Chromium 87–112 快照测试,以自制探针扩展与真实的 Google Translate 2.0.13 / 2.0.18、AdBlock 区分“安装”“启用”和“后台实际运行”;CRX 安装路径以企业策略强制安装验证。Chrome for Testing 不含 Google 的分阶段推送,上文是代码生效的版本,真实用户遇到的时间可能稍晚。未覆盖 Windows、Mac、Edge 及其他 Chromium 浏览器。150 以后的日期按 Chrome 四周发布节奏估算。
Edge 等其他 Chromium 浏览器有各自的停用进度,本文未实测。