macOS 上装 OpenUtau｜损坏提示与 Gatekeeper 放行

先确认你的 Mac 芯片

点击左上角苹果图标 → 关于本机 → 查看"芯片"一栏：

• Apple Silicon（M1 / M2 / M3 / M4 / 系列）→ 下载 OpenUtau-osx-arm64.dmg
• Intel → 下载 OpenUtau-osx-x64.dmg

下载位置在 OpenUtau 官方安装页。

分步安装

第一步：下载并挂载 dmg

双击下载的 .dmg 文件，Finder 会弹出一个窗口，里面有 OpenUtau.app 和 Applications 文件夹图标。

第二步：拖进 Applications

把 OpenUtau.app 拖到 Applications 文件夹图标上（或者直接拖到左侧 Finder 侧边栏的"应用程序"）。

第三步：放行 Gatekeeper（关键）

OpenUtau 没有付费购买 Apple Developer 证书，macOS 的 Gatekeeper 会把它标记为"不受信任"。第一次双击时会弹提示：

"OpenUtau" 已损坏，无法打开。您应该将它移到废纸篓。

或者：

无法打开 "OpenUtau-osx-x64.dmg"，因为无法验证开发者。

放行方法：打开"终端"（Applications → Utilities → Terminal），粘贴以下命令并回车：

xattr -rc /Applications/OpenUtau.app

如果连 dmg 都打不开（第二条提示），先放行 dmg 文件：

xattr -rc ~/Downloads/OpenUtau-osx-x64.dmg

然后再双击 dmg 挂载、拖进 Applications、再执行 xattr -rc /Applications/OpenUtau.app。

这条命令会清除 macOS 给文件附加的隔离属性（com.apple.quarantine），让 Gatekeeper 把它当成你自己放进去的程序。

第四步：首次启动

到 Applications 文件夹里双击 OpenUtau，会再弹一次提示"这是从互联网下载的应用"，点"打开"即可。

第一次启动会选 UI 语言。后续可以在 OpenUtau → Preferences 里改。

第五步：DiffSinger 运行时

macOS 上跑 DiffSinger 有额外要求：

• macOS 11 Big Sur 或更新（Catalina 不支持）
• Apple Silicon 推荐，Intel 也能跑但 CoreML 加速效果有限
• CoreML 加速在 Preferences → Machine Learning Runner → CoreML

nsf_hifigan vocoder 需要单独下载（Windows diffsingerpack 已内置，macOS 不行）。下载 .oudep 文件后拖拽到 OpenUtau 窗口即可导入。

macOS 常见坑

坑一：空白窗口

Intel 芯片 macOS 系统上可能遇到 OpenUtau 启动后 Piano Roll 窗口白屏。把窗口拖动或改变尺寸就正常了——这是已知 bug。

坑二：声库文件名乱码

从 Windows 系统创建的 UTAU 声库（zip）在 macOS 上解压后文件名可能乱码。OpenUtau 的 Tools → Install Singer... 工具可以正确处理编码——它会弹一个文件编码选择框，选对编码（中文声库选 UTF-8，日文声库可能需要 Shift-JIS）就能正确安装。

坑三：macOS 自动解压

Safari 默认会自动解压 .zip 和 .dmg 文件。如果发现下载的 dmg 文件"打不开"，可能已经被自动解压成 app 了，去 Downloads 文件夹找 .app 文件直接拖到 Applications 即可。如果被 Gatekeeper 拦截，同样用 xattr 命令放行。

坑四：Wine 兼容重采样器

macOS 原生只支持 OpenUtau 内置的 Worldline 重采样器和 WORLDLINE-R 曲线引擎。想在 macOS 上跑 Windows .exe 格式的外部重采样器（如 moresampler、tn_fnds、straycat-rs），需要 OpenUtau 自带的 Wine 兼容层——从 0.1.565 版本起支持直接配置，不再需要手动写 wrapper。详见官方重采样器安装教程。