双击.pkg安装失败是因macOS权限、隔离属性或系统卷状态阻断，非安装包损坏；可依次尝试绕过Gatekeeper、移除quarantine属性、终端命令行安装、查install.log日志定位具体错误。

当你双击.pkg文件后弹出“安装器遇到了一个错误，导致安装失败”提示，不是安装包本身损坏，而是macOS在执行安装脚本、校验签名或写入系统路径时被权限、隔离属性或目标卷状态阻断。这个错误不显示具体原因，但每种触发场景都有对应解法。

先绕过Gatekeeper拦截再试一次

绝大多数“安装器遇到错误”实际源于Gatekeeper对未公证安装包的静默拦截——它不弹窗警告，却在后台终止安装流程。

点按屏幕左上角苹果图标 → “系统设置” → 左侧选择“隐私与安全性” → 滚动到底部找到“安全性”区域。

若看到灰色文字提示“已阻止来自互联网的xxx.pkg”，点击右侧【仍要打开】按钮，输入开机密码确认。

再次双击.pkg文件，此时应能进入正常安装向导。这一步跳过了首次拦截，无需改系统设置。

用终端强制移除隔离属性

macOS 10.15 Catalina及之后版本会给所有网页下载的.pkg自动添加com.apple.quarantine扩展属性，哪怕你已允许“任何来源”，该属性仍会干扰installer进程内部调用。

打开“终端”，粘贴以下命令（把/path/to/your.package.pkg替换成你pkg文件的实际路径）：

sudo xattr -d com.apple.quarantine /path/to/your.package.pkg

注意：路径必须准确，建议直接把.pkg文件拖进终端窗口，让系统自动生成路径，避免手动输错斜杠或空格。

回车后输入管理员密码（无字符显示），等待光标返回即完成。现在双击安装即可。

终端指定系统卷安装（最稳定方案）

图形界面安装依赖多个后台服务协同，一旦某个组件异常（如Installer.app崩溃、launchd代理失效），就会报“遇到错误”却不说明哪步失败。终端命令行绕过全部GUI层，直连底层installer工具，输出明确，成功率最高。

第一步：打开“终端”。可用Command + 空格呼出聚焦搜索，输入“终端”后回车。

第二步：输入命令并回车：

sudo installer -pkg /path/to/your.package.pkg -target /

第三步：把.pkg文件直接拖进终端窗口，替换掉/path/to/your.package.pkg部分，确保路径完整且无多余空格。

第四步：回车 → 输入管理员密码（无视觉反馈）→ 等待终端返回“The installation was successful”。

检查安装日志定位真实错误

如果以上三步都失败，说明问题出在安装包自身逻辑或系统环境深层异常，必须查日志才能知道哪一行脚本崩了。

在“访达”中按下Shift + Command + G，输入/var/log，回车进入日志目录。

找到install.log文件，用“文本编辑”打开，滚动到底部，查看最近几条以“installer”开头的记录。

常见错误线索包括：“PackageKit: Error Domain=PKInstallErrorDomain Code=112”（权限不足）、“Could not find volume”（目标卷不可写）、“Failed to execute script”（postinstall脚本崩溃）。

根据日志中的Code编号或关键词，可进一步判断是重置Receipts权限、更换安装目标卷，还是联系软件作者获取修复版pkg。