createinstall 是一款功能强大的 macOS 安装工具，主要用于创建自定义的 macOS 安装程序、系统镜像或启动盘，它支持从官方安装程序或恢复分区提取系统文件，并允许用户添加驱动、软件、脚本等自定义内容，适合需要批量部署 macOS 或制作个性化安装系统的用户，以下将详细介绍 createinstall 的使用教程，涵盖环境准备、功能解析、操作步骤及注意事项，帮助用户快速上手。
环境准备
在使用 createinstall 前，需确保满足以下条件：
- 硬件要求：一台运行 macOS 10.13 或更高版本的 Mac 电脑，建议预留至少 20GB 可用存储空间用于存放临时文件和最终安装包。
- 系统版本：需与目标安装的 macOS 版本一致或更高，例如创建 Ventura 安装程序时，建议在 Ventura 系统上操作。
- 软件下载：从 GitHub 官方仓库（https://github.com/createinstallmedia/createinstall）下载最新版 createinstall，或通过 Homebrew 安装：
brew install createinstall。 - 权限设置：确保终端拥有管理员权限，部分操作可能需要输入用户密码。
核心功能解析
createinstall 的核心功能可通过命令行参数实现，主要功能包括：
| 功能 | 参数示例 | 说明 |
|---------------------|-----------------------------------|----------------------------------------------------------------------|
| 提取安装文件 | createinstall --extract /path/to/Install macOS.app | 从官方安装程序中提取系统文件至指定目录，生成可定制的安装镜像。 |
| 创建安装程序 | createinstall --create /path/to/output.dmg | 基于提取的系统文件生成新的安装程序（.dmg 或 .iso）。 |
| 添加自定义驱动 | --add-driver /path/to/kext | 向安装镜像中添加第三方驱动（如 NVIDIA 显卡驱动），解决硬件兼容性问题。 |
| 注入启动脚本 | --preinstall /path/to/script.sh | 在安装前执行指定脚本，可用于自动分区、配置网络等操作。 |
| 设置安装选项 | --volume-name "My macOS" --hide-apps "Safari" | 自定义安装卷标名称、隐藏默认应用或添加许可证协议。 |
详细操作步骤
提取官方安装程序文件
（1）从 App Store 下载目标版本的 macOS 安装程序（如 “Install macOS Ventura.app”），默认位于 /Applications 目录。
（2）打开终端，执行以下命令提取系统文件：
createinstall --extract /Applications/Install\ macOS\ Ventura.app /path/to/extracted_files
/path/to/extracted_files 为自定义输出目录，执行后会生成包含系统内核、基础框架和安装脚本的文件夹。
自定义安装镜像
（1）添加驱动：若需支持非原生硬件（如第三方 Wi-Fi 卡），将驱动文件（.kext 或 .pkg）放入 extracted_files/Extra 目录，或通过参数指定路径：
createinstall --add-driver /path/to/MyDriver.kext --extract /Applications/Install\ macOS\ Ventura.app /path/to/output
（2）配置安装选项：通过 --config 参数加载 XML 配置文件，或直接在命令行中设置。
createinstall --create /path/to/custom_installer.dmg --volume-name "Custom macOS" --hide-apps "TV"
（3）注入脚本：将预处理脚本（如磁盘分区脚本）放入 extracted_files/Scripts 目录，并在创建时指定：
createinstall --preinstall /path/to/preinstall.sh --create /path/to/output.dmg
生成最终安装包
完成自定义后,执行以下命令生成安装镜像：
createinstall --create /path/to/final_installer.dmg --source /path/to/extracted_files
生成的 .dmg 文件可直接挂载使用，或通过 createinstall 的 --usb 参数写入 U 盘制作启动盘：
createinstall --usb /dev/diskX --source /path/to/extracted_files
（注意：/dev/diskX 需替换为实际的磁盘设备号，可通过 diskutil list 查询。）
注意事项
- 数据安全：操作前务必备份重要数据，避免因误操作导致系统损坏。
- 驱动兼容性：第三方驱动需与目标 macOS 版本匹配，建议优先使用 Apple 官方认证的驱动。
- 脚本调试：预处理脚本建议先在测试环境中验证，避免安装过程中出现错误。
- 版本限制：createinstall 不支持跨版本创建安装程序（如从 Monterey 创建 Ventura 安装包）。
相关问答FAQs
Q1：使用 createinstall 创建的安装包是否支持跨平台安装？
A1：不支持，createinstall 仅适用于在 Mac 电脑上创建 macOS 安装程序，且目标设备需为 Apple Silicon 或 Intel 架构的 Mac，若需在非 Mac 设备上安装 macOS，需借助其他工具（如 OpenCore Legacy Patcher）并自行处理驱动和兼容性问题。
Q2：创建安装包时提示 “Error: Invalid image size”，如何解决？
A2：该错误通常由目标磁盘空间不足或镜像文件格式不支持导致，可尝试以下方法：
（1）确保输出目录有至少 10GB 可用空间；
（2）检查磁盘格式是否为 APFS 或 HFS+，可通过 diskutil eraseDisk APFS "Untitled" /dev/diskX 格式化磁盘；
（3）若写入 U 盘，建议先使用 diskutil unmountDisk /dev/diskX 卸载磁盘后再执行命令。
