相容性指南

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 瀏覽器有各自的停用進度,本文未實測。