Mac开源软件因签名过期被Gatekeeper拦截导致闪退或无反应,可通过右键打开放行、清除隔离属性并重签名、启用Rosetta模式或更新至带有效签名的新版解决。

Mac上开源软件因签名过期突然闪退或双击无反应,不是程序损坏,而是Gatekeeper在加载可执行段前就终止了进程——你看到的“已损坏”“无法验证开发者”等提示,本质是系统拒绝运行签名失效的二进制文件。
确认确实是签名过期引发的问题
别急着重签名,先用终端快速验真:打开「终端」,输入 xattr -l /Applications/你的应用.app(把“你的应用.app”替换成真实路径)。如果输出里没有 com.apple.quarantine,但运行时报“证书已过期”或 codesign --verify /Applications/你的应用.app 显示 invalid signature,就坐实了是签名过期。
注意:若输出中含 com.apple.quarantine,说明是下载隔离导致,不是签名问题,应跳过本流程直接走清除隔离步骤。
右键打开 + 手动放行(最快见效,适合单次验证)
这一步不改系统、不碰终端,5秒内完成信任登记。
在访达中找到该开源应用 → 按住Control键点击图标 → 选“打开” → 弹窗点“仍要打开” → 再点“打开”。
成功后系统会为该应用实例写入临时白名单,后续双击即可启动。这步做完立刻测试是否还闪退——如果正常了,说明问题纯属签名拦截,无需继续操作。
清除隔离属性并强制重签名(推荐给长期使用该开源软件的用户)
签名过期时,仅清除quarantine不够;必须重建ad-hoc签名才能通过Gatekeeper检查。此操作需Xcode Command Line Tools支持。
第一步:打开终端,输入 sudo xattr -r -d com.apple.quarantine,末尾留一个空格。
第二步:前往「访达 → 应用程序」,将目标应用(如 Homebrew 安装的 jq 或 GitHub 下载的 gping.app)直接拖入终端窗口,路径自动填充。
第三步:按回车 → 输入管理员密码(输入过程无任何字符显示,属正常现象)→ 等待光标返回即清除完成。
第四步:紧接着输入重签名命令 sudo codesign --force --deep --sign -,同样末尾留空格,再把同一应用拖入终端。
【必须确认终端最后一行输出是“replacing existing signature”,否则签名未生效,重启后仍会闪退】
若报错 “resource fork, Finder information, or similar detritus”,请改用完整命令:sudo codesign --force --deep --preserve-metadata=entitlements,requirements,flags --sign -,再拖入应用执行。
启用Rosetta模式(M系列芯片用户必查)
很多开源工具(如旧版fzf、某些Rust编译的CLI二进制)仍以Intel架构打包,Apple Silicon Mac在签名过期叠加架构不兼容时,会静默崩溃——连错误日志都不生成。
方法一:访达 → 应用程序 → 右键应用图标 → “显示简介” → 勾选【使用Rosetta打开】→ 关闭窗口 → 重新启动。
方法二:若勾选项灰色不可点,说明系统已锁定其为Apple Silicon专用,需先在终端执行:sudo xattr -d com.apple.architecture x86_64 /Applications/你的应用.app,再回简介窗口勾选。
更新到带有效签名的新版(治本之策)
签名过期往往意味着该开源项目已停止维护或长期未发布新版,继续硬签存在兼容性与安全风险。
访问该项目的GitHub Releases页面或官网,确认是否有2026年内发布的新版本;旧版.dmg或.zip可能被CDN缓存,务必删除本地安装包,重新下载最新安装文件。
若该软件由Homebrew Cask管理,直接运行:brew reinstall --cask 你的应用名,Homebrew会自动拉取带新签名的最新版并覆盖安装。











