.pkg安装失败时，可依次尝试图形界面双击安装、终端指定系统卷安装、终端指定外接卷安装、验证包完整性及枚举合法目标卷五种方法。

如果您下载了以.pkg为后缀的软件安装包，但无法正常启动安装流程或安装失败，则可能是由于权限不足、路径错误、目标卷不可用或包内容异常所致。以下是解决此问题的步骤：

一、图形界面双击安装

该方法适用于绝大多数标准.pkg文件，依赖macOS内置安装程序自动解析安装逻辑并引导用户完成授权与路径选择，无需命令行操作，适合普通用户快速部署。

1、在“访达”中定位到已下载的.pkg文件，通常位于“下载”文件夹或桌面。

2、双击该.pkg文件，系统将自动调用“安装程序”应用并弹出首个界面，显示软件名称与版本信息。

3、点击“继续”，阅读许可协议，滚动至底部后点击“同意”。

4、确认安装位置，默认为“Macintosh HD”，若无特殊需求请保持不变。

5、点击“安装”，系统弹出管理员密码输入框，必须输入当前账户的登录密码（非Apple ID密码），输入时无视觉反馈属正常现象。

6、等待进度条完成，出现“安装成功”提示后点击“关闭”。

二、终端命令行安装（指定系统卷）

该方法绕过图形界面，直接调用installer工具执行安装，适用于脚本集成、批量部署或图形环境异常时使用，安装过程由终端输出实时反馈。

1、打开“终端”应用，可通过Command + 空格呼出聚焦搜索，输入“终端”后回车。

2、输入以下命令，将/path/to/your.package.pkg替换为实际.pkg文件的绝对路径（可拖拽文件到终端窗口自动生成路径）：

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

3、按回车后，系统会提示输入管理员密码，输入时屏幕无字符显示，属正常行为，输入完毕后回车。

4、观察终端输出，出现“The install was successful.”即表示完成。

三、终端命令行安装（指定外接卷）

当需将软件安装至外置硬盘、Time Machine备份盘或网络挂载卷时，必须显式指定目标卷的挂载路径，否则installer无法识别有效安装域。

1、在终端中运行命令列出所有已挂载卷：

ls /Volumes/

2、从输出中确认目标卷名称（如MySSD、BackupDrive），确保该卷已正确挂载且未被加密锁定。

3、执行安装命令，将MySSD替换为实际卷名：

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

4、输入管理员密码后等待执行完成，终端将返回安装结果状态。

四、安装前验证pkg包完整性与可信度

在执行任何安装操作前，检查.pkg包的元数据可有效规避恶意软件或损坏包导致的系统风险，尤其适用于非官方渠道获取的安装包。

1、在终端中运行以下命令查看基础信息：

installer -pkginfo -pkg /path/to/your.package.pkg

2、重点关注输出中的identifier（如com.microsoft.office）和version字段是否与官方文档一致。

3、检查scripts字段是否为空或仅含标准预/后安装脚本，若出现可疑路径或未知shell命令应立即中止安装。

4、确认无异常后，再选用前述任一安装方式执行。

五、枚举并确认合法安装目标卷

在搭载APFS容器、多个启动卷、FileVault加密卷或Time Machine本地快照的系统中，installer可能无法默认识别全部可用目标，需主动查询支持域列表。

1、运行以下命令获取当前系统中所有被installer识别为有效安装目标的卷：

installer -dominfo -pkg /path/to/your.package.pkg

2、观察输出中每项的can be targeted字段，仅标记为YES的volume路径才可作为-target参数值。

3、从中选取所需卷的完整路径（如/Volumes/Macintosh HD - Data），代入安装命令执行。