.pkg安装失败时，可依次尝试图形界面双击安装、终端指定系统卷安装、终端指定外接卷安装、验证包完整性及枚举合法目标卷五种方法。
如果您下载了以.pkg为后缀的软件安装包，但无法正常启动安装流程或安装失败，则可能是由于权限不足、路径错误、目标卷不可用或包内容异常所致。以下是解决此问题的步骤：
一、图形界面双击安装
该方法适用于绝大多数标准.pkg文件，依赖mac OS内置安装程序自动解析安装逻辑并引导用户完成授权与路径选择，无需命令行操作，适合普通用户快速部署。
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/通义灵码 Mac版通义灵码 Mac版是阿里云推出的一款AI智能编码助手，深度集成于Xcode、VS Code及JetBrains等主流IDE中。它基于大模型技术，支持行级/函数级实时续写、自然语言生成代码、单元测试生成及智能问答等核心功能。macOS用户可通过插件市场直接安装，开箱即用，旨在辅助开发者高效完成编码任务，提升研发效率。
下载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），代入安装命令执行。