HMCL 下载安装教程：Windows / macOS / Linux 全平台

一、下载前先选对安装包

HMCL 提供三种安装包，内容一致，按操作系统任选其一：

• .jar（跨平台通用包）：Windows / Linux / macOS 都能用，但要求本机已安装 Java 8 或更高版本
• .exe（Windows 可执行版）：双击即可运行，适合不熟悉 Java 配置的 Windows 用户
• .sh（Linux / macOS 脚本）：下载后执行 chmod +x HMCL-*.sh 赋予运行权限，再双击或终端运行

提醒：请从官方渠道获取安装包，下载后建议对照官方渠道公布的 SHA-256 校验文件完整性。会下载代码的启动器容易被杀毒软件启发式误判，校验通过后加入白名单即可。

二、Java 环境准备

运行 HMCL 本体需要 Java 8 及以上；启动不同版本的 Minecraft 对 Java 的要求不同：

• Minecraft 1.17 及以上：建议 Java 17 或 21
• Minecraft 1.16 及以下：Java 8

HMCL 内置 Java 检测，首次启动时会扫描系统中已安装的 Java；列表为空时会引导你下载合适的运行时。

三、首次启动的配置

打开启动器后，按下面的顺序完成初始化：

• 登录：正版用户选择微软账号登录；离线模式仅用于本地体验场景。
• 设置 Java：在全局设置或版本设置中选择 Java 运行时。
• 下载游戏：在「下载」页选择游戏版本，HMCL 会自动完成版本与依赖的安装。

四、常见误区

• 把启动器放在含特殊字符的路径下，可能读不到资源文件。
• 给低配电脑分配过大的内存，反而会因 GC 压力导致卡顿，一般 4 GB 内存机器分配 2 GB 即可。
• macOS 用户如果无法打开 .dmg 或提示「已损坏」，请在「系统设置 → 隐私与安全性」中放行。