openutau 中文文档 下载 App

prefs.json 损坏｜删了重建，OpenUtau 不会永久损坏

问题表现

以下任意一种都可能是 prefs.json 损坏：

prefs.json 是什么

prefs.json 是 OpenUtau 的全局偏好配置文件——存所有 Preferences 里的设置：

完全不含：

解决方案：删掉它

第一步：完全关掉 OpenUtau

确保 OpenUtau 进程真的退出了（任务管理器检查）。

第二步：找到 prefs.json

prefs.json 位置取决于 OpenUtau 安装方式：

安装方式prefs.json 位置
便携版（.zip）OpenUtau.exe 同目录
安装版（.exe 安装器）Documents/OpenUtau/prefs.json
macOS / Linux~/.config/OpenUtau/prefs.json 或 ~/.local/share/OpenUtau/

第三步：备份（可选）

删掉前可以复制一份到桌面备份——如果只是想临时恢复默认再看哪些设置值得保留。

第四步：删掉

直接删 prefs.json。OpenUtau 下次启动会自动重建一个新的默认配置。

第五步：重新打开 OpenUtau

启动正常。然后重新配置 Preferences：

  1. Tools → Preferences
  2. 界面语言、Additional Singer Path、DirectML、自动保存间隔……
  3. 全部设好后 OK

为什么删 prefs.json 是安全的

不会丢失什么

内容安全
所有声库（UTAU Classic / DiffSinger / ENUNU）✅ 在 Singers 文件夹里，不受影响
所有重采样器✅ 在 Resamplers 文件夹里
所有工程文件（.ustx）✅ 工程文件本身，完全独立
DiffSinger vocoder✅ 单独安装的，不在 prefs.json 里
Additional Singer Path⚠️ 会丢（在 prefs.json 里），需要重设
DirectML / CoreML 设置⚠️ 会丢，重设后记得重启
界面语言⚠️ 会恢复成跟随系统，重设
Custom Expressions⚠️ 会丢（在 prefs.json 里），需要重新加

会丢失的只是偏好设置

删掉 prefs.json 是最安全的排查手段——任何偏好配置异常、损坏、冲突都能一键修复。如果 OpenUtau 启动就崩，第一件事就是删 prefs.json。

其他配置文件

除了 prefs.json，OpenUtau 还有一些其他可能损坏的配置文件：

文件作用删它安全吗
prefs.json全局偏好✅ 安全
express.json自定义表达式✅ 安全（和 prefs.json 类似）
updater.json更新检查✅ 安全
声库的 character.yaml声库元信息❌ 别删——删了声库不认识
oto.ini声库音素表❌ 别删
.ustx 工程文件工程数据❌ 别删

删错了文件可能导致声库不识别或工程丢。只有 prefs.json（以及极少数情况下的 express.json）是"删了不会坏事"的配置文件。

防止 prefs.json 损坏

损坏原因通常是：

对策：

  1. 定期备份 prefs.json（复制一份到别处）
  2. 升级 OpenUtau 前先复制 prefs.json 备份
  3. 杀毒软件里把 OpenUtau 目录加白名单