Skip to content

Commit b0d9836

Browse files
zkiteflyGlavo3gf8jv4dv
authored
添加“JVM 选项与环境变量”文档 (#203)
* Create jvm-options.md * Update jvm-options.md * Update jvm-options.md * Update jvm-options.md * Update jvm-options.md * Update _launcher/jvm-options.md Co-authored-by: 3gf8jv4dv <[email protected]> * Update _launcher/jvm-options.md Co-authored-by: 3gf8jv4dv <[email protected]> * Update _launcher/jvm-options.md Co-authored-by: 3gf8jv4dv <[email protected]> * Update _launcher/jvm-options.md Co-authored-by: 3gf8jv4dv <[email protected]> * Update _launcher/jvm-options.md Co-authored-by: 3gf8jv4dv <[email protected]> * Update _launcher/jvm-options.md Co-authored-by: 3gf8jv4dv <[email protected]> * Update _launcher/jvm-options.md Co-authored-by: 3gf8jv4dv <[email protected]> * Update _launcher/jvm-options.md Co-authored-by: 3gf8jv4dv <[email protected]> * Update _launcher/jvm-options.md Co-authored-by: 3gf8jv4dv <[email protected]> * Update _launcher/jvm-options.md Co-authored-by: 3gf8jv4dv <[email protected]> * Update _launcher/jvm-options.md Co-authored-by: 3gf8jv4dv <[email protected]> * Update _launcher/jvm-options.md Co-authored-by: 3gf8jv4dv <[email protected]> --------- Co-authored-by: Glavo <[email protected]> Co-authored-by: 3gf8jv4dv <[email protected]>
1 parent 8842140 commit b0d9836

File tree

1 file changed

+113
-0
lines changed

1 file changed

+113
-0
lines changed

‎_launcher/jvm-options.md‎

Lines changed: 113 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,113 @@
1+
---
2+
title: "JVM 选项与环境变量"
3+
permalink: /launcher/jvm-options-and-env.html
4+
date: 2025-04-20 23:18:02 +0800
5+
categories: 启动器
6+
toc: true
7+
---
8+
9+
![Hits](https://hits.zkitefly.eu.org/?tag=https%3A%2F%2Fdocs.hmcl.net%2Flauncher%2Fjvm-options.html)
10+
11+
## JVM 选项
12+
13+
HMCL 提供了一些 JVM 选项用于调试目的。你可以通过在启动 HMCL 时添加这些参数来使用这些功能。
14+
15+
| 参数 | 描述 |
16+
|------|------|
17+
| `-Dhmcl.home=<path>` | 覆盖 HMCL 数据文件夹路径 |
18+
| `-Dhmcl.self_integrity_check.disable=true` | 禁用启动器更新时的本体完整性检查 |
19+
| `-Dhmcl.bmclapi.override=<url>` | 自定义 BMCLAPI 的 API Root 地址（默认为 `https://bmclapi2.bangbang93.com`）|
20+
| `-Dhmcl.font.override=<font family>` | 指定启动器使用的字族 |
21+
| `-Dhmcl.version.override=<version>` | 手动指定启动器版本号 |
22+
| `-Dhmcl.update_source.override=<url>` | 自定义 HMCL 更新源地址 |
23+
| `-Dhmcl.authlibinjector.location=<path>` | 指定本地 authlib-injector 路径，不从网络下载 |
24+
| `-Dhmcl.openjfx.repo=<maven repository url>` | 添加用于下载 OpenJFX 的自定义 Maven 仓库地址（默认为 `https://repo1.maven.org/maven2`）|
25+
| `-Dhmcl.native.encoding=<encoding>` | 指定系统原生编码 |
26+
| `-Dhmcl.microsoft.auth.id=<App ID>` | 自定义 Microsoft OAuth 应用程序 ID |
27+
| `-Dhmcl.microsoft.auth.secret=<App Secret>` | 自定义 Microsoft OAuth 应用程序密钥 |
28+
| `-Dhmcl.curseforge.apikey=<key>` | 自定义 CurseForge API 密钥 |
29+
| `-Dhmcl.discoapi.override=<url>` | 自定义 DiscoAPI 的 API Root 地址（默认为 `https://api.foojay.io/disco/v3.0`）|
30+
31+
## 环境变量
32+
33+
HMCL/HMCLauncher 也支持一些环境变量来配置启动器的行为。你可以在系统环境变量中添加这些变量。
34+
35+
| 参数 | 描述 |
36+
|------|------|
37+
| `HMCL_JAVA_OPTS` | 自定义 HMCLauncher 所使用的 JVM 启动参数（默认为 `-XX:MinHeapFreeRatio=5 -XX:MaxHeapFreeRatio=15`）|
38+
| `HMCL_JAVA_HOME` | 自定义 HMCLauncher 所使用的 Java 路径 |
39+
| `HMCL_FONT` | 指定启动器使用的字族 |
40+
| `HMCL_JRES` | 添加 HMCL 所使用的 Java 路径，支持写入多个路径 |
41+
42+
## 如何使用 JVM 选项
43+
44+
你可以通过以下几种方式使用这些 JVM 选项。
45+
46+
### 方法一：直接在命令行中添加
47+
48+
在启动 HMCL 时通过命令行添加参数，例如：
49+
50+
```bash
51+
java -Dhmcl.home="D:/Games/HMCL" -jar HMCL.jar
52+
```
53+
54+
### 方法二：创建启动脚本
55+
56+
1. Windows 用户可以创建 `.cmd` 文件：
57+
```batch
58+
@echo off
59+
java -Dhmcl.font.override="Microsoft YaHei" -jar HMCL.jar
60+
pause
61+
```
62+
63+
2. Linux/macOS 用户可以创建 `.sh` 文件：
64+
```bash
65+
#!/bin/bash
66+
java -Dhmcl.font.override="Noto Sans CJK SC" -jar HMCL.jar
67+
```
68+
69+
### 使用注意事项
70+
71+
- 可以同时使用多个参数，只需要用空格分隔
72+
- 包含空格的参数值需要用半角引号包裹
73+
- 确保 JVM 参数位于 `-jar HMCL.jar` 之前
74+
75+
## 如何使用环境变量
76+
77+
### Windows 设置环境变量
78+
79+
1. 右键点击“此电脑”/“这台电脑”/“我的电脑”，选择“属性”
80+
2. 点击“高级系统设置”
81+
3. 点击“环境变量”
82+
4. 在“用户变量”或“系统变量”中点击“新建”
83+
5. 输入变量名（如 `HMCL_JAVA_HOME`）和变量值
84+
6. 点击“确定”保存
85+
86+
示例值：
87+
```
88+
变量名: HMCL_JAVA_HOME
89+
变量值: C:\Program Files\Java\jdk-17
90+
```
91+
92+
### Linux/macOS 设置环境变量
93+
94+
1. 编辑你的 Shell 配置文件（比如 `~/.bashrc`、`~/.zshrc` 等）
95+
2. 添加 `export` 语句：
96+
97+
```bash
98+
export HMCL_JAVA_HOME="/usr/lib/jvm/java-17-openjdk"
99+
export HMCL_JAVA_OPTS="-XX:MinHeapFreeRatio=5 -XX:MaxHeapFreeRatio=15"
100+
```
101+
102+
3. 保存文件并重新加载配置：
103+
```bash
104+
source ~/.bashrc # 或 `source ~/.zshrc`
105+
```
106+
107+
### 使用注意事项
108+
109+
- 设置环境变量后需要重启 HMCL 才能生效
110+
- 如果同时设置了 JVM 参数和环境变量，JVM 参数优先级更高
111+
- Windows 用户注意使用半角分号（;）分隔多个路径
112+
- Linux/macOS 用户注意使用半角冒号（:）分隔多个路径
113+

0 commit comments

Comments
 (0)