关于Safari Web Extension模板代码运行卡顿的技术咨询

这个问题我之前帮不少开发者排查过类似情况，结合你用的Xcode12.2 + Safari14.0.1环境，大概率是Safari Web Extension在早期版本的进程初始化优化不足，但也有几个可以快速验证的点帮你区分是Bug还是配置遗漏：

一、先区分Debug和Release模式的差异 #

Xcode模板默认的Debug模式会加载额外的调试钩子和日志监控，这会显著增加Extension首次启动的耗时。你可以试试：

• 用Archive打包成Release版本，通过Ad Hoc方式安装到本地Safari
• 再测试首次点击工具栏项的加载速度，大概率延迟会大幅降低

如果Release模式下还是有5秒延迟，那更偏向是系统版本的Bug。

二、排查模板默认配置的小细节 #

虽然你没修改代码，但可以快速确认两个关键配置：

• 打开Extension的Info.plist，检查SFSafariWebsiteAccess字段是否为All（模板默认值），如果是Specific可能会触发额外的权限校验延迟
• 确认NSExtensionActivationRule是否为模板默认的TRUEPREDICATE，过于复杂的激活规则也可能拖慢加载

不过这些配置在模板里都是最优设置，大概率不是问题根源。

三、对比Web Extension和App Extension的核心差异 #

你提到这个问题在Safari App Extension里没出现，这是因为两者的运行机制完全不同：

• Safari App Extension是基于AppKit的原生组件，加载时直接调用系统原生控件，启动流程更轻量
• Safari Web Extension是基于WebKit的网页容器，首次加载需要初始化独立的JS沙盒进程、加载Web资源，而Safari14.0.1版本的WebKit在Extension进程管理上确实存在已知的延迟Bug，Apple在后续的Safari14.1+和Xcode13版本中修复了这个问题。

四、临时缓解方案（如果暂时无法升级环境） #

如果没法立刻升级Xcode和Safari，你可以在background.js里提前预加载popover资源，避免首次点击时才启动加载流程：

chrome.runtime.onStartup.addListener(() => {
    // 预加载popover页面，提前初始化Web上下文
    const preloadTab = chrome.tabs.create({
        url: chrome.runtime.getURL("popover.html"),
        active: false,
        pinned: false
    });
    // 预加载完成后关闭隐藏标签页，避免占用资源
    chrome.tabs.onLoaded.addListener((tabId) => {
        if (tabId === preloadTab.id) {
            chrome.tabs.remove(tabId);
        }
    });
});

这个方法会在Extension启动时创建一个隐藏标签页预加载popover，首次点击时就能直接复用已初始化的Web上下文，大幅降低延迟。

总结 #

综合来看，这更像是Safari14.0.1与Xcode12.2组合下的已知兼容性Bug，升级到Xcode13+和Safari14.1以上版本后，这个加载延迟问题基本会消失。如果升级后依旧存在，建议清空Safari的Extension缓存（偏好设置->扩展->选中你的Extension->右键卸载，再重新编译安装）试试。

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