Chrome扩展Manifest V3开发如何兼容旧版Chrome及适配不同API？

旧版 Chrome 安装 MV3 扩展的异常表现 #

• Chrome 88 是首个正式支持 Manifest V3 的版本，低于该版本的Chrome完全无法识别MV3格式的清单文件，会直接提示扩展安装失败，报错「清单文件无效」。
• 88~96 区间的版本虽然允许安装MV3扩展，但大部分MV3专属API处于未完成或实验状态，会出现两种问题：调用不存在的API直接抛出未定义错误，对应功能完全失效；或是API行为和高版本实现不一致，触发预期外的逻辑异常。

多版本API适配的必要性判断 #

你可以结合你的扩展目标用户群体决定是否适配：

• 如果你的扩展面向的是使用较新Chrome的群体（比如开发者、企业内部指定版本的用户），可以直接在manifest.json中配置minimum_chrome_version字段，设置你开发验证过的最低版本，直接阻止低版本用户安装，避免兼容问题。
• 如果需要覆盖更多存量低版本用户，就需要做对应API的兼容适配。

API兼容适配方案 #

针对你提到的chrome.runtime.getURL和chrome.extension.getURL这类新旧API替换的场景，优先用特性检测做封装，不需要硬编码判断Chrome版本，示例实现如下：

// 封装统一的资源路径获取方法
function getExtensionAssetUrl(path) {
  // 优先调用高版本API
  if (typeof chrome.runtime.getURL === 'function') {
    return chrome.runtime.getURL(path);
  }
  // 降级调用旧版API
  return chrome.extension.getURL(path);
}

// 业务代码调用
const logoUrl = getExtensionAssetUrl('logo128.png');

其他适配建议：

• 所有用到的MV3新增API都加特性检测，不存在对应API时可以做降级处理，或是提示用户升级Chrome版本。
• 如果兼容成本过高，可以选择同时维护Manifest V2和Manifest V3两个版本的扩展，分别上架应用商店，但该方案的后续维护成本会明显提升。

内容的提问来源于stack exchange，提问作者Abhishek Sarkar