Chrome 悄然杀死了 Manifest V2。有一天，网上应用店停止接受 MV2 提交。如果您将浏览器扩展构建为独立产品堆栈的一部分，那么该截止日期已经过去了。清单V3不再是可选的。这是城里唯一的游戏。

问题不在于是否采用MV3。问题是如何重新思考您的架构，以便您不再与平台对抗并开始使用它。这种转变比大多数教程所承认的还要大。

为什么 MV3 感觉像是一个不同的运行时

将 MV2 后台脚本视为永不休眠的服务器。你的变量永远存在在那里。你的计时器可靠地滴答作响。状态总是温暖且准备就绪。

MV3 将其替换为服务人员。 Service Worker 被设计为短暂的。当内存压力达到时，Chrome 可以终止它们，然后唤醒它们以处理下一个事件。无法保证您的工作人员在两次选项卡激活之间仍处于活动状态。

这不是一个错误。这就是设计。 Chrome 做出了这种权衡，以减少恶意扩展的攻击面。您是否同意这种权衡并不重要。您的架构必须考虑到这一点。

更深层的含义是：您存储在后台脚本内的变量中的任何内容现在都是致命的。您需要一个外部持久层。铬存储成为您的单一事实来源，而不是方便的 API。

存储问题比您想象的要严重

chrome.storage.local 默认上限为 10MB。对于存储首选项的简单扩展来说，这已经足够了。对于缓存 API 响应、跟踪用户行为或存储文档内容的扩展，10MB 很快就会消失。

大多数开发人员忽视的解决方案是索引数据库。它存在于浏览器中，处理千兆字节的数据，并支持事务。可以通过 Service Workers、弹出页面和内容脚本访问它。然而，Service Worker 对 IndexedDB 的访问在旧版 Chrome 中存在可靠性错误。如果您选择此路线，请定位 Chrome 102 或更高版本。

以下是在 MV3 Service Workers 中可靠运行的最小 IndexedDB 设置：

// storage.js，适用于 SW、弹出窗口和内容脚本
const DB_NAME = 'MyExtensionDB';
常量 DB_VERSION = 1;

导出函数 openDatabase() {
  返回新的 Promise((解决, 拒绝) => {
    const req = indexedDB.open(DB_NAME, DB_VERSION);

    req.onupgradeneeded = (事件) => {
      const db = event.target.result;
      if (!db.objectStoreNames.contains('cache')) {
        const store = db.createObjectStore('cache', { keyPath: 'key' });
        store.createIndex('时间戳', '时间戳', { unique: false });
      }
    };

    req.onsuccess = (事件) => 解析(event.target.result);
    req.onerror = (事件) => 拒绝(event.target.error);
  });
}

导出异步函数 saveRecord(key, data) {
  const db = 等待 openDatabase();
  返回新的 Promise((解决, 拒绝) => {
    const tx = db.transaction('缓存', '读写');
    tx.objectStore('cache').put({ key, data, timestamp: Date.now() });
    tx.oncomplete = 解决；
    tx.onerror = 拒绝；
  });
}

此模式可以免费为您提供崩溃恢复。如果 Chrome 在会话中终止您的 Service Worker，数据仍然存在。当软件重新启动时，它会从 IndexedDB 读取并干净地恢复。

计时器今非昔比

独立开发人员经常构建需要按计划完成工作的扩展。想想成本跟踪器、提醒工具或同步实用程序。在MV2中，你扔了一个设置时间间隔在你的后台脚本中并忘记了它。

在 MV3 中，这种方法被打破了。 Chrome 可能会在下一个间隔触发之前终止您的 Service Worker。你会得到间隙。您会错过更新。您会让提交错误报告的用户感到沮丧。

替代品是chrome.alarms。 Service Worker 重新启动后警报仍然存在。 Chrome 会专门唤醒您的软件来处理每个警报事件。限制时间最短为一分钟。您不能每五秒发出一次警报。

对于亚分钟更新，正确的模式是拆分方法。您的弹出页面运行自己的设置时间间隔当它打开时，因为弹出页面在可见时有稳定的生命周期。当弹出窗口关闭时，警报会处理持久性。这涵盖了实时显示情况和后台持久化情况，无需黑客攻击。

令您措手不及的安全要求

MV3收紧内容安全政策显著地。在 MV2 中有效的两种模式会破坏您的扩展审查或导致运行时错误。

没有远程脚本执行

如果您的扩展从 CDN 获取脚本并动态运行它，那么这种情况就消失了。所有 JavaScript 都必须在提交时与您的扩展程序捆绑在一起。这会影响从外部 URL 加载图表库、分析脚本或实用程序代码的扩展。

修复方法很简单：使用构建工具在本地捆绑所有内容，例如esbuild或汇总。您将获得更小、更快、可审核的捆绑包。如果没有新的 Store 提交，您将失去推送 JS 更新的能力。相应地规划您的发布节奏。

innerHTML 是一种责任

MV3不禁内部HTML直截了当。但是，将其与任何用户提供的或 API 获取的内容一起使用会创建一个 XSS 向量，审阅者将对其进行标记。更严格的 CSP 使得利用变得更加困难，但正确的做法是完全停止将innerHTML 用于动态内容。

切换到 DOM 创建方法。使用文档.createElement和文本内容对于您不完全控制的任何数据。这也使您的扩展更容易审核，从而加快 Web Store 审核速度。

MV3 独立开发者的实际成本是多少

让我们诚实地讨论这里的权衡。 MV3 迁移不是免费的。这是您所支付的费用：

更多异步代码：每个状态读取都会命中存储。您编写更多的等待调用。更多错误处理。更多的认知开销。
更长的审核周期：更严格的 CSP 意味着更多的审稿人审查。为您的第一次 MV3 提交预留额外的时间。
报警粒度限制：最少一分钟会完全扼杀某些产品创意。后台价格检查器、实时跟踪器和心跳功能都需要重新设计。
捆绑纪律：没有远程脚本意味着您的构建管道很重要。如果您还没有合适的捆绑器，那么您需要一个合适的捆绑器。
IndexedDB 复杂度：基于 Promise 的 API 很冗长。尽早包装它或使用像这样的瘦库有据可查的存储抽象供参考模式。

此外，强制异步无处不在的方法改变了您的测试方式。依赖同步状态读取的单元测试需要重写。将其纳入您的迁移估算中。

MV3 给您带来什么回报

这些限制确实有好处。异步优先模型意味着您的扩展程序默认会正常处理浏览器重新启动和崩溃。 Chrome 更新时用户不会丢失状态。您的扩展程序在各个会话中的行为都是可预测的。

加强安全措施也有助于增强信任。经过多年的恶意软件报道，用户对扩展程序越来越怀疑。基于 MV3 构建的扩展具有干净、可审核的捆绑包，更容易向持怀疑态度的用户解释。如果您公开推广您的扩展，那么信任信号很重要。一个免费社交媒体审核工具可以帮助您评估您的扩展程序的营销是否在跨平台上获得了正确的可信度信号。

此外，强制捆绑规则通常会产生更小、更快的扩展。延迟加载被故意的代码分割所取代。性能的提高是约束的副作用。

下一个扩展构建的实用步骤

如果您今天开始新的扩展或计划迁移，这里有一个具体的清单：

审核您的扩展所需的每一个状态。决定 chrome.storage.local 中的内容、IndexedDB 中的内容以及可以按需派生的内容。
将所有后台 setInterval 调用替换为 chrome.alarms。重新设计任何需要亚分钟后台更新的功能。
在本地捆绑所有依赖项。在编写第一行扩展代码之前设置 esbuild 或 Rollup。
在处理外部数据的每个文件中，将innerHTML 用法替换为DOM 方法。
编写一次 openDB 辅助函数并将其导入到任何地方。不要在每个模块中重写 IndexedDB 设置。
显式测试 Service Worker 终止。使用 Chrome DevTools 手动停止您的软件并验证您的扩展程序是否正确恢复。

这web.dev 学习资源深入涵盖 Service Worker 生命周期。在构建后台逻辑之前阅读该文档将为您节省数小时的调试时间。

适合 MV3 工作流程的工具

构建扩展的独立开发人员通常身兼数职。您编写代码、设计 UI 并处理营销工作。保持工具链精简很重要。

为了在 Beta 测试期间共享您的扩展，免费二维码生成器让您无需额外设置即可为 Chrome 网上应用店列表创建可扫描的链接。对于现场演示或会议摊位很有用。

如果您的扩展程序捕获屏幕截图或处理图像，AI背景去除器帮助您快速为网上应用店列表创建干净的促销资产。

在启动之前，通过以下方式运行扩展程序的登陆页面：免费网站评分器发现可能损害有机发现的搜索引擎优化和性能问题。

如果您的扩展程序以任何方式处理媒体文件，那么了解格式的工作原理很重要。一个免费视频到 MP3 转换器是思考基于浏览器的文件处理管道的行为方式的一个很好的参考点。

扩展程序 UI 的可访问性也很重要。这A11Y项目有实用的清单，使弹出页面和内容脚本可供每个人使用。这是 MV3 没有直接解决的一个领域，但 Web Store 审阅者确实注意到了可访问性问题。

独立扩展构建者的底线

清单V3是一个比 MV2 更难构建的平台。异步要求、存储限制和计时器限制会产生真正的摩擦。然而，这些限制也会促使您采用更具弹性、更可审计的代码。

最困难的开发人员是那些尝试直接移植 MV2 模式的开发人员。能够蓬勃发展的开发人员是那些接受新约束作为设计输入并从一开始就重新思考其架构的开发人员。

这种权衡值得吗？对于大多数独立扩展项目来说，是的。网上商店仍然是一个可行的分销渠道。用户基数巨大。货币化选项是真实的。您现在只需要以不同的方式进行构建。

从您的状态模型开始。只要做到这一点，MV3 扩展的其余部分就会就位。如果出错，您将花费数周时间调试 Service Worker 终止边缘情况，这些情况感觉像是随机错误。

这篇文章包含附属链接。如果您通过这些链接进行购买，我们可能会赚取佣金，而无需您支付额外费用。