3分钟搞定！macOS虚拟机自定义安装路径全攻略：告别默认限制
项目地址: https://gitcode.com/gh_mirrors/ma/macos-virtualbox 还在为VirtualBox虚拟机占用系统盘空间发愁？安装路径无法自定义导致存储管理混乱？本文将通过修改macos-guest-virtualbox.sh脚本中的环境变量，3步实现macOS虚拟机安装路径自由，让你的存储资源分配更高效。读完本文你将掌握：自定义虚拟机存储路径的核心参数配置、动态调整磁盘大小的技巧、以及避坑指南。
为什么需要自定义安装路径
默认情况下，macos-guest-virtualbox.sh会将虚拟机文件存储在系统默认位置（通常是C盘或主目录），这会导致：
- 系统盘空间快速耗尽
- 多虚拟机环境下存储管理混乱
- 机械硬盘与固态硬盘性能无法区分利用
通过环境变量配置，可将虚拟机文件定向到任意存储路径，充分利用闲置磁盘空间。
核心环境变量解析
macos-guest-virtualbox.sh脚本第16-87行定义了关键配置变量，其中与存储相关的核心参数如下：
| 参数名 | 默认值 | 功能说明 |
|---|---|---|
storage_size | 80000 | 虚拟机磁盘大小（MB），最小22000 |
storage_format | "vdi" | 磁盘格式，支持"vdi"或"vmdk" |
vm_name | "macOS" | 虚拟机名称，影响存储路径中的文件夹名 |
注：完整参数列表可通过执行
./macos-guest-virtualbox.sh documentation查看官方文档
自定义安装路径实战步骤
步骤1：修改脚本配置变量
- 用文本编辑器打开macos-guest-virtualbox.sh
- 定位到第16行的
set_variables()函数 - 添加自定义存储路径变量（示例中设置为D盘macOS_VMs目录）：
# 自定义存储路径配置（添加在第17行下方）
vm_storage_path="/d/macOS_VMs" # Linux/macOS路径示例
# vm_storage_path="D:\macOS_VMs" # Windows路径示例（需使用双反斜杠）
- 修改默认存储相关参数：
vm_name="macOS-Catalina" # 第18行，建议包含系统版本便于区分
storage_size=102400 # 第20行，调整为100GB（102400MB）
storage_format="vmdk" # 第21行，如需跨平台使用可改为vmdk
步骤2：配置VirtualBox全局设置
- 打开VirtualBox
- 进入「管理」→「全局设定」→「默认虚拟电脑位置」
- 设置为与脚本中
vm_storage_path相同的路径 - 点击「确定」保存设置
此步骤确保VirtualBox默认使用自定义路径，避免脚本配置与软件设置冲突。
步骤3：验证路径配置
执行以下命令检查配置是否生效：
# 显示当前配置
grep -A 10 "set_variables()" macos-guest-virtualbox.sh | grep -E "vm_name|storage_|vm_storage_path"
预期输出应包含自定义的路径和存储参数：
vm_name="macOS-Catalina" # name of the VirtualBox virtual machine
storage_size=102400 # VM disk image size in MB, minimum 22000
storage_format="vmdk" # VM disk image file format, "vdi" or "vmdk"
vm_storage_path="/d/macOS_VMs" # 自定义存储路径
高级技巧：动态调整磁盘大小
若需在安装后调整磁盘容量，可使用VirtualBox自带工具：
# 调整VMDK格式磁盘大小（需先转换为VDI）
VBoxManage clonehd "macOS-Catalina.vmdk" "temp.vdi" --format vdi
VBoxManage modifyhd "temp.vdi" --resize 153600 # 调整为150GB
VBoxManage clonehd "temp.vdi" "macOS-Catalina.vmdk" --format vmdk
rm temp.vdi
注意：调整后需在macOS系统内使用「磁盘工具」扩展分区才能实际使用新增空间
常见问题解决
问题1：路径包含空格导致脚本执行失败
解决方法：使用双引号包裹路径变量，例如：
vm_storage_path="/media/user/external drive/macOS VMs"
问题2：权限不足无法写入目标路径
解决方法：设置目标目录权限：
chmod -R 755 "/d/macOS_VMs" # Linux/macOS系统
# Windows系统需在文件资源管理器中调整安全权限
问题3：修改后虚拟机无法启动
排查步骤：
- 检查路径是否包含非ASCII字符
- 验证磁盘格式与VirtualBox版本兼容性
- 通过
VBoxManage showvminfo "macOS-Catalina"查看错误信息
总结与注意事项
通过修改macos-guest-virtualbox.sh脚本中的环境变量，我们实现了macOS虚拟机安装路径的完全自定义。关键注意点：
- 路径中避免使用中文和特殊字符
- 建议将
storage_size设置为实际需求的1.5倍（预留更新空间） - VMDK格式适合跨平台迁移，VDI格式性能更优
- 所有修改需在首次执行脚本前完成，已创建的虚拟机需手动迁移
按照本文方法配置后，你可以在执行./macos-guest-virtualbox.sh时，看到安装文件自动存储到指定路径，系统盘空间占用问题将得到彻底解决。
提示：更多高级配置可参考项目README.md文档，遇到问题可通过脚本内置帮助系统获取支持。
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
