hmcl启动器更新需先检查自动更新是否启用,再手动触发检查或下载安装包覆盖升级;也可切换开发版通道尝鲜,或删除update.json和version.lock强制重置更新状态。

HMCL启动器如何更新?最新版本升级方法——当你点击“启动游戏”却提示“版本加载失败”或发现模组管理界面空白、下载源无法连接时,大概率是启动器版本过旧,必须手动触发更新或更换渠道才能恢复功能。
检查并启用自动更新
启动HMCL后,系统默认每24小时自动检测一次新版本。若你从未更改过设置,这一步通常已就绪。
进入【设置】→【启动器更新】→确认“自动检查更新”已勾选。该选项一旦关闭,后续所有版本都不会主动提醒。
点击右侧的【立即检查】按钮,等待几秒。如果服务器返回“已是最新版本”,说明当前运行的是3.3.201或更高(截至2026年6月,最新稳定版为3.3.205);若提示“发现新版本”,直接点击【下载并安装】即可。
手动下载安装包覆盖升级
方法一:从官网获取安装包
访问 HMCL 官方发布页(https://hmcl.huangyuhui.net/download),选择与你系统匹配的安装包(Windows用.exe、macOS用.dmg、Linux用.AppImage)。
【关键前提】关闭所有HMCL进程后再双击安装包,否则新文件无法写入被占用的配置目录。
安装程序会自动识别旧版安装路径,并保留你的账号、游戏版本、模组列表和界面设置。安装完成后直接启动,无需重新配置。
方法二:用开发版通道尝鲜
如果你需要提前体验修复了版本列表加载失败的新逻辑,可切换至开发版通道:【设置】→【启动器更新】→【更新渠道】→选择“开发版”→点击【立即检查】。
开发版每日构建,但可能含未合入稳定分支的调试代码。若更新后出现界面错位或Java路径丢失,退回稳定版即可。
强制重置更新状态(适用于卡在旧版本)
第一步:完全退出HMCL,包括托盘残留进程(Windows任务管理器中结束hmcl.exe,macOS活动监视器中查找HMCL)。
第二步:定位配置目录。Windows默认在%APPDATA%\HMCL,macOS在~/Library/Application Support/HMCL,Linux在~/.hmcl。
第三步:删除其中的update.json和version.lock两个文件。它们记录了上次更新尝试的版本号和校验值,删掉后启动器将无视缓存,重新向服务器请求最新版本信息。
第四步:重启HMCL,它会立刻执行版本检测,不再显示“已是最新”的假消息。











