返回博客列表
扩展开发
逐步迁移到Manifest V3:Chrome扩展manifest.json改写流程
Google Chrome 官方团队
2025年11月30日
清单文件权限迁移V3Manifest配置

从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或动态插入