返回博客列表
扩展开发

逐步迁移到Manifest V3:Chrome扩展manifest.json改写流程

Google Chrome 官方团队
2025年11月30日
清单文件权限迁移V3Manifest配置
Manifest V3迁移步骤, chrome扩展升级manifest.json, V2到V3权限适配, chrome manifest_version 3 改写法, chrome扩展host_permissions配置, service_worker后台脚本转换, manifest V3 action字段替代browser_action, chrome扩展新审核要求适配, manifest.json字段对照表

从V2到V3:为什么现在必须动手

2025年6月起,Chrome Web Store已冻结所有新增Manifest V2扩展的上传;现有V2项目虽仍可更新,但商店会在2026年6月全面停止公网分发。对于仍在维护的插件,提审时审核员会优先检测manifest_version字段,一旦发现值为2,即提示「请迁移至Manifest V3」。若扩展日活在1万以上或代码行数超过5千,一次性重写风险高,采用「渐进迁移+灰度发布」才是运营成本最低的路线。

核心差异集中在三点:后台脚本被Service Worker取代;远程代码执行被禁止;权限必须拆分为host_permissions与optional_host_permissions。许多早期依赖background.page长期驻留内存、使用eval或动态插入

想了解更多?

探索 Chrome 的功能特性和下载选项