空白窗口｜Intel macOS 白屏 / Windows 启动白屏临时修复

问题表现

打开 OpenUtau 后：

• 主窗口空白一片，什么都不显示
• 或 Piano Roll 区域白屏，只剩侧边栏
• 或启动画面后卡住，主界面不出来

Intel macOS 白屏（已知 bug）

最常见——Intel 芯片 macOS 上某些版本 OpenUtau 有这个 bug。

症状

打开 Piano Roll 后白屏，或整个 OpenUtau 主界面空白。

解决方法

改变窗口大小就行：

• 拖动 OpenUtau 窗口的边缘 → 白屏区域自动重新渲染 → 恢复正常
• 或最小化再恢复 → 也是一次 resize 触发重新渲染

这是临时修复——每次遇到白屏都这样处理。升级 OpenUtau 到最新版可能永久修复（Avalonia UI 框架的已知渲染 bug，社区一直在更）。

永久改善

• OpenUtau 升级到最新版
• macOS 系统也升级（Ventura / Sonoma 比旧版稳定）
• 如果你有 Apple Silicon Mac，OpenUtau 在 M 系列上完全没有这个问题

Windows 启动白屏

Windows 上的空白窗口通常原因不同：

原因一：显卡驱动

OpenUtau 用 Avalonia UI（跨平台 .NET UI 框架）——在 Windows 上用 DirectX 渲染。显卡驱动太老或损坏可能导致 Avalonia 渲染失败。

解决方法：升级显卡驱动到最新版（NVIDIA / AMD / Intel 各自官方支持页）。

原因二：DirectML / GPU 加速

如果你之前在 Preferences 里打开了 DirectML，然后显卡驱动更新或切换了 GPU（核显 ↔ 独显），可能导致 Avalonia 和 DirectML 冲突。

解决方法：

1. 删 prefs.json（强制恢复默认偏好）→ 重开 OpenUtau
2. 如果还是白屏 → OpenUtau → Preferences → Machine Learning → 把 DirectML 切回 CPU → 重开
3. CPU 渲染正常了再慢慢调 DirectML

原因三：.NET 8 版本

. NET 8 有多个 patch 版本（8.0.0 → 8.0.10 → …）。某些 patch 版本的 Avalonia 渲染有 bug。

解决方法：去 .NET 下载页装最新的 .NET 8 Desktop Runtime（不是 Preview / RC 版）。

macOS 启动直接闪退 + 白屏

Intel Mac 上：

1. 删 prefs.json（重启恢复默认偏好）
2. 用 Rosetta 2 转译（如果是 Apple Silicon 版本误装到 Intel Mac）
3. 升级 macOS（至少 Catalina → Big Sur 或更新）

Apple Silicon Mac 上 OpenUtau 几乎不会白屏。

Linux 启动空白

Linux 上 OpenUtau 用 X11 / Wayland 渲染：

1. 确认图形服务器正常（echo $XDG_SESSION_TYPE → x11 / wayland）
2. 某些 Wayland 下 Avalonia 渲染有问题 → 切换到 X11 session 试试
3. 装最新 .NET 8 Runtime（.NET 8 在 Linux 上也有多个 patch 版本）

还不行怎么办

按这个顺序排查：

1. 删 prefs.json → 强制恢复所有默认偏好
2. 升级 OpenUtau 到最新版 → GitHub Releases 下最新 stable
3. 升级 .NET Runtime 到最新 patch 版本
4. 升级显卡驱动
5. 换个用户账户 / 换台电脑 → 如果其他机器上正常，说明你的系统环境有问题
6. OpenUtau GitHub Issues 里搜 "blank window" / "white screen" → 看看有没有类似问题和修复讨论

如果以上都不行，在 GitHub Issues 提 bug——附带上系统版本、.NET 版本、OpenUtau 版本、错误日志（如果有）。