终端安装.pkg至APFS卷失败，寻求解决办法或替代方案

我之前处理过好几例APFS卷下命令行安装pkg失败的情况，结合你的问题，给你几个经过测试的解决思路和替代方案：

1. 检查并修复APFS卷状态 #

命令行的installer工具对卷的状态敏感度比GUI更高，先确认卷是否存在权限或文件系统问题：

• 查看卷的详细信息，确认是否有“Disabled”相关标记：

  diskutil info /Volumes/Macintosh\ HD
  

• 尝试修复APFS卷（如果是系统卷，可能需要重启到恢复模式执行此命令）：

  sudo diskutil apfs repairVolume /Volumes/Macintosh\ HD
  

修复完成后再重新执行安装命令。

2. 调整installer命令的目标参数 #

有时候指定卷的完整路径会触发APFS的识别问题，改用根目录作为目标可能解决：

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

如果想排查更详细的错误原因，可以加上-verbose参数查看安装日志：

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

3. 确保卷处于可读写状态 #

部分APFS卷可能因系统更新或异常操作变为只读挂载，GUI安装会自动处理，但命令行需要手动调整：

• 先检查挂载状态：

  mount | grep /Volumes/Macintosh\ HD
  

如果输出包含read-only，重新挂载为可读写：

sudo mount -uw /Volumes/Macintosh\ HD

之后再执行安装命令。

4. 手动提取并安装pkg内容 #

如果以上方法都无效，可以绕过installer工具，直接提取pkg内容手动部署：

1. 提取pkg到临时目录：

   pkgutil --expand /path/to/your/package.pkg /tmp/pkg_extracted
   

2. 解压Payload包（pkg的核心文件内容）：

   cd /tmp/pkg_extracted && tar -xf Payload
   

3. 复制文件到系统对应位置（注意权限）：

   sudo cp -R /tmp/pkg_extracted/Payload/* /
   

4. （可选）如果pkg包含预安装/后安装脚本，需要手动执行：

   sudo sh /tmp/pkg_extracted/Scripts/preinstall
   sudo sh /tmp/pkg_extracted/Scripts/postinstall
   

为什么GUI安装正常？ #

GUI的Installer.app内置了更完善的卷状态检测和自动修复逻辑，比如会自动处理APFS卷的挂载权限、容器状态等问题，而命令行的installer工具则更严格，不会自动修复这些前置问题，因此出现差异。

内容的提问来源于stack exchange，提问作者Danny Shepherd