HMCL启动器怎么重置设置？恢复默认配置文件教程

最彻底的解决方式是重置配置文件——删除hmcl.json文件，清空自定义设置并恢复首次运行状态，但保留saves、mods、resourcepacks和versions等游戏数据。

HMCL启动器界面错乱、主题异常、账号消失或设置无法保存时，最彻底的解决方式是重置配置文件——这会清空所有自定义设置，让启动器回归首次运行状态，但保留已下载的游戏版本和存档数据。

确认重置范围与影响

重置操作仅删除 【hmcl.json 配置文件】 和界面个性化数据（如主题色、字体、窗口大小），不会删除 .minecraft 文件夹中的 saves（世界存档）、mods（模组）、resourcepacks（资源包）或 versions（游戏版本文件）。你的游戏进度和模组安装记录完全安全。

注意：重置后需重新登录账户、重新选择语言和主题，但无需重新下载任何游戏版本。

Windows系统一键重置法

第一步：关闭所有HMCL进程，包括后台托盘图标（右键任务栏图标→退出）

第二步：按 Win + R，输入 %APPDATA%\.hmcl → 回车，打开配置目录

第三步：删除该目录下的 hmcl.json 文件（不要删整个 .hmcl 文件夹）

第四步：双击 HMCL.exe 重启启动器，它会自动生成全新的默认配置文件并进入初始设置流程

macOS/Linux手动重置路径

方法一（推荐）：终端执行以下命令（自动定位并删除）

rm -f ~/Library/Application\ Support/hmcl/hmcl.json（macOS）

rm -f ~/.hmcl/hmcl.json（Linux）

方法二：打开文件管理器，前往对应路径，手动找到并删除 hmcl.json

⚠️ 提醒：Linux用户若使用 Flatpak 版本，配置路径为 ~/.var/app/org.jackhuang.hmcl/config/hmcl/hmcl.json，不是 ~/.hmcl

强制跳过向导并恢复原始默认值

如果重置后仍残留旧设置（比如语言未恢复为简体中文），说明系统环境变量干扰了初始化逻辑。

在启动HMCL前，临时清除语言环境变量：

Windows：以管理员身份运行CMD，输入 set HMCL_LANGUAGE= && start "" "D:\Games\HMCL\HMCL.exe"（替换为你的真实路径）

macOS/Linux：终端执行 unset HMCL_LANGUAGE && ./HMCL

这一步能绕过环境变量强制设定，确保启动器读取内置默认语言 zh-Hans 和主题 light