启动不了｜.NET 8 运行时缺失排查清单

问题表现

双击 OpenUtau.exe 后没反应或弹错误提示：

必须安装 .NET Desktop Runtime 才能运行此应用程序。

或者 PowerShell 里 dotnet --list-runtimes 看不到任何 8.x 版本。

快速排查（3 步）

第一步：检查有没有 .NET 8

PowerShell 或终端里跑：

dotnet --list-runtimes

必须看到一条包含：

Microsoft.WindowsDesktop.App 8.x.x

（Windows）或

Microsoft.NETCore.App 8.x.x

（macOS / Linux）

如果列表为空或没有 8.x → 没装 → 跳到第二步。

第二步：下载 .NET 8

Windows 用户必须下载 .NET 8 Desktop Runtime（不是 ASP.NET Runtime，也不是 SDK）：

• 微软 .NET 下载页
• 找 8.0 → Runtime → Desktop
• 下载 .exe 安装包（x64 / x86 / arm64 对应你系统）
• 双击安装，一路下一步
• 不用重启电脑，关掉 OpenUtau 再开就行

macOS 用户：

• 找 .NET 8 Runtime（macOS 没有 Desktop Runtime 区分）
• 下载 .pkg 或 Homebrew brew install --cask dotnet-sdk

第三步：验证

再跑 dotnet --list-runtimes，确认 8.x 在列表里。重新打开 OpenUtau，应该能正常启动。

版本对应关系

如果装了 .NET 8 还是启动不了，去官方 Release Page 确认当前版本的 .NET 要求。

踩过的坑

坑一：装了 SDK 没装 Desktop Runtime

很多人看到"装 .NET"就去装 SDK（工具链），但 Windows Desktop SDK 自带的 Runtime可能不包含 WPF 组件（OpenUtau 用 Avalonia UI 但底层仍需 Desktop Runtime）。稳妥做法：单独装一份 Desktop Runtime（几十 MB），和 SDK 不冲突。

坑二：多版本冲突

同时装了 .NET 6 + .NET 7 + .NET 8 没问题——OpenUtau 会自己找 8.x。不需要卸旧版本。如果 OpenUtau 版本升到需要 .NET 10，也可以和 .NET 8 共存。

坑三：企业电脑被组策略锁

公司电脑的组策略可能禁装 .NET Runtime，或者已经预装的版本太旧。这种情况只能：

• 联系 IT 部门装 .NET 8
• 或换个人电脑跑 OpenUtau

OpenUtau 不支持"绿色免安装版"绕过 .NET 检查。

坑四：.NET 8 装了但 OpenUtau 仍然提示缺失

检查：

1. .NET 版本是不是太新（比如 Preview 版）？OpenUtau 只认正式发布的 Runtime
2. OpenUtau 是不是便携版从压缩包解压后直接双击？有些杀毒软件会误拦截 .NET Runtime 的启动器
3. 运行 OpenUtau 是不是被杀毒软件隔离了？临时关掉杀毒软件试一下

Linux 上的 .NET 问题

Linux 上 .NET Runtime 的安装比较麻烦（不同发行版方式不同）。推荐：

wget https://dot.net/v1/dotnet-install.sh
chmod +x dotnet-install.sh
./dotnet-install.sh --channel 8.0

装完后，确保 ~/.dotnet 在 PATH 里。否则 OpenUtau 找不到 dotnet。