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