Safari扩展不生效需从权限、签名、配置、兼容性四层排查：先检查系统设置中“扩展”开关和“允许来自App Store的扩展”是否开启，再确认Safari偏好设置中扩展已勾选；若显示“未验证的开发者”，需在钥匙串中信任其证书；最后验证是否适配Manifest V3及当前Safari版本。
你在Safari里明明勾选了AdGuard、1Password或翻译扩展，但地址栏不显示图标、右键菜单没新增选项、刷新页面后脚本也不执行——这说明扩展已加载失败或被系统静默拦截，必须从权限、签名、配置、兼容性四层逐级排查。
检查Safari扩展开关与基础状态
第一步：打开Safari→顶部菜单栏点击“Safari”→“偏好设置”→切换到“扩展”标签页。
第二步：在左侧列表中找到目标扩展，确认其右侧复选框已被勾选；若为灰色不可点，跳转至系统权限环节。
第三步：勾选后，观察扩展右下角是否显示“未验证的开发者”字样——若出现，说明签名未被系统信任，需手动处理证书。
授予Safari“完全磁盘访问”权限
macOS Catalina起强制要求此权限，否则Safari连Extensions文件夹都读不到，所有扩展开关必然变灰。
打开“系统设置”→左侧边栏点击“隐私与安全性”→向下滚动找到“完全磁盘访问”。
点击右侧锁形图标，输入管理员密码解锁设置。
点击“+”号→按住Command键，在弹出窗口中依次前往“访达”→“应用程序”，右键“Safari.app”→“在访达中显示”，将它直接拖入权限列表。
【若此前已添加过但问题仍在，需先取消勾选再重新勾选一次】。
验证并信任扩展签名证书
未被钥匙串信任的签名证书会导致扩展被静默禁用，即使安装成功也不会出现在启用列表中。
方法一：通过Safari界面快速定位问题
打开Safari→“偏好设置”→“扩展”标签页，查看目标扩展右下角是否显示“未验证的开发者”。
方法二：手动信任证书
关闭Safari→打开“钥匙串访问”→顶部搜索框输入扩展Bundle ID（如com.adguard.safari）→双击匹配的证书→展开“信任”→将“代码签名”设为“始终信任”→输入密码确认。
重启Safari后进入扩展页面重试启用。
重置Safari扩展核心配置文件
权限和证书都正确，但界面仍空白、开关失效或启用后立即退回到关闭状态，说明ExtensionRegistry或com.apple.Safari.Extensions.plist已损坏。
第一步：退出Safari并清空扩展缓存目录
按Command + Shift + G，在访达中前往：~/Library/Caches/com.apple.Safari/→删除其中名为“ExtensionCache”和“ExtensionRegistry”的文件（若存在）。
第二步：重置扩展偏好配置
再次按Command + Shift + G，前往：~/Library/Preferences/→找到并删除com.apple.Safari.Extensions.plist（注意不是com.apple.Safari.plist）。
第三步：重建系统服务注册表
打开“终端”，粘贴执行以下命令：/System/Library/Frameworks/CoreServices.framework/Frameworks/LaunchServices.framework/Support/lsregister -kill -r -domain local -domain system -domain user
等待终端返回“Done.”后，关闭终端，重启Safari。
确认扩展适配Manifest V3与当前Safari版本
macOS Sonoma 14.6+已全面停用Manifest V2，旧版扩展（如部分AdGuard、Grammarly旧包）会直接被拒载。
访问扩展官网，下载标注支持“macOS Sonoma 14.6+”及“Safari 17.6+”的最新安装包。
卸载当前版本：前往~/Library/Safari/Extensions/，将对应.safariwebextension文件夹拖出桌面暂存。
双击新下载的.safariwebextension文件，Safari弹出“添加扩展”确认框时，点击“添加”即可立即生效。
