兼容性指南

Manifest V2 与 Manifest V3:每个 Chrome 版本能装什么

从 Chrome 87 到 156,按版本顺序看清两种扩展格式何时能用、何时失效,以及下载旧版本前该注意什么。

2026 年 10 月 19 日更新 · 基于 Linux 实测

Manifest V2 与 Manifest V3 是什么

Manifest V2
Chrome 扩展的旧格式。扩展以常驻的后台页面运行,可以直接拦截和修改网络请求。Chrome 正在逐步停用它。
Manifest V3
Chrome 扩展的现行格式,Chrome 88 起支持。后台改为按需启动的 service worker,网络过滤改用声明式规则(declarativeNetRequest),权限也更严格。

每个扩展的 manifest.json 都写明自己使用哪种格式;下文简称 MV2 和 MV3。

当前阶段151+约 2026年7月起

Manifest V2 彻底退出

Manifest V2拒绝安装
Manifest V3正常运行

浏览器里已不再包含任何 MV2 开关或策略,所有方法都被拒绝。MV3 没有上限:从 88 到我们测试的 156 一直正常运行,真正的风险只剩“浏览器太旧”。

  1. 156实测最新版:MV2 全部拒绝,MV3 正常。实测
  2. 151命令行开关全部失效。实测
137 – 1502025年5月 – 2026年6月

MV2 拒绝安装

Manifest V2拒绝安装
Manifest V3正常运行

普通用户已无法使用 MV2:安装被拒绝,也不能重新启用,开发者模式和“加载已解压的扩展程序”都无济于事。只有企业策略(到 138)和命令行开关(到 150)还能临时保留。

  1. 150命令行开关最后一个有效版本(还需额外重新启用)。实测
  2. 139企业策略 ExtensionManifestV2Availability 被移除。实测
  3. 137默认拒绝安装 MV2,无法重新启用。实测
129 – 1362024年9月 – 2025年5月

MV2 默认被停用

Manifest V2默认停用,可手动启用
Manifest V3正常运行

MV2 扩展仍能安装,但装好后处于停用状态(unsupportedManifestVersion)。用户可以在 chrome://extensions 手动重新启用,启用后照常运行。Google 从 2024 年 10 月起分批推送,部分用户晚些才遇到。

  1. 2024年10月Google 开始向用户分批停用。官方文档
  2. 129代码默认值开始停用 MV2。实测
92 – 1282021年7月 – 2024年8月

两种格式并存,MV3 能力陆续补齐

Manifest V2正常运行
Manifest V3正常运行

MV2 和 MV3 都能正常使用,这是兼容性最宽松的一段。MV3 的新接口一个个加入:用到它们却没有声明最低版本的扩展,在旧浏览器里能装上,但相关功能会失效。

  1. 127–128MV2 仍正常运行;Chrome 开始在扩展页提示 MV2 即将停用。实测
  2. 120userScripts 权限可用(还需用户在扩展页开启)。官方文档
  3. 114sidePanel 侧边栏可用。实测
  4. 109offscreen 接口可用;更早版本能装能跑,但调用失败。实测
  5. 2022年1月Chrome 应用商店不再接受新的 MV2 扩展(商店政策,不影响浏览器)。商店政策
  6. 96declarativeNetRequestWithHostAccess 权限可用。官方文档
  7. 92ES 模块后台开始运行。实测
88 – 912021年1月 – 2021年7月

MV3 进入稳定版

Manifest V2正常运行
Manifest V3正常运行

Chrome 88 起 MV3 扩展可以安装并运行。但写成 ES 模块("type": "module")的后台在 92 之前仍然装上却不运行。

  1. 88–91模块后台在列表里显示有 service worker,实际从不启动。实测
  2. 88MV3 基础支持:安装、启用、后台运行全部通过。实测
≤ 872021年1月以前

只有 MV2 的年代

Manifest V2正常运行
Manifest V3装上但不运行

Manifest V2 是唯一的正式格式。MV3 扩展在稳定版里能装上、看起来已启用,但后台脚本从不运行——这是最难察觉的失败。

  1. 87稳定版 87 最高只认 manifest_version 2;service_worker 后台仅限 Dev 渠道。源码核对
137

Chrome 137 起 MV2 拒绝安装,普通用户没有任何绕过办法。

129

Chrome 129–136 会自动停用 MV2 扩展,但用户仍可在扩展页手动重新启用。

88

MV3 需要 Chrome 88 或更高版本,更旧的浏览器会“装上但不运行”。

下载旧版本前

  1. 先看 Manifest 版本:Chrome 137 及以上只选 MV3。
  2. 再看最低版本:低于声明值会被拒绝安装。
  3. 浏览器太旧时,选与之兼容的最新版本,或先升级浏览器。
测试方法与局限

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 浏览器有各自的停用进度,本文未实测。