4. JVM 运行时参数
4.1 JVM 参数选项
参数来源:https://docs.oracle.com/javase/8/docs/technotes/tools/unix/java.html
类型一:标准参数选项
特点:
- 比较稳定,后续版本基本不会变化
- 以
-开头
直接在 DOS 窗口中运行 java 或者 java -help 可以看到所有的标准选项
- JDK 8
- JDK 21
D:\Java\jdk-1.8\bin>java -help
用法: java [-options] class [args...]
(执行类)
或 java [-options] -jar jarfile [args...]
(执行 jar 文件)
其中选项包括:
-d32 使用 32 位数据模型 (如果可用)
-d64 使用 64 位数据模型 (如果可用)
-server 选择 "server" VM
默认 VM 是 server.
-cp < 目录和 zip/jar 文件的类搜索路径 >
-classpath < 目录和 zip/jar 文件的类搜索路径 >
用 ; 分隔的目录, JAR 档案
和 ZIP 档案列表, 用于搜索类文件。
-D< 名称 >=< 值 >
设置系统属性
-verbose:[class|gc|jni]
启用详细输出
-version 输出产品版本并退出
-version:< 值 >
警告: 此功能已过时, 将在
未来发行版中删除。
需要指定的版本才能运行
-showversion 输出产品版本并继续
-jre-restrict-search | -no-jre-restrict-search
警告: 此功能已过时, 将在
未来发行版中删除。
在版本搜索中包括 / 排除用户专用 JRE
-? -help 输出此帮助消息
-X 输出非标准选项的帮助
-ea[:<packagename>...|:<classname>]
-enableassertions[:<packagename>...|:<classname>]
按指定的粒度启用断言
-da[:<packagename>...|:<classname>]
-disableassertions[:<packagename>...|:<classname>]
禁用具有指定粒度的断言
-esa | -enablesystemassertions
启用系统断言
-dsa | -disablesystemassertions
禁用系统断言
-agentlib:<libname>[=< 选项 >]
加载本机代理库 <libname>, 例如 -agentlib:hprof
另请参阅 -agentlib:jdwp=help 和 -agentlib:hprof=help
-agentpath:<pathname>[=< 选项 >]
按完整路径名加载本机代理库
-javaagent:<jarpath>[=< 选项 >]
加载 Java 编程语言代理, 请参阅 java.lang.instrument
-splash:<imagepath>
使用指定的图像显示启动屏幕
有关详细信息, 请参阅 http://www.oracle.com/technetwork/java/javase/documentation/index.html。
C:\Users\Administrator>java -help
用法:java [options] < 主类 > [args...]
(执行类)
或 java [options] -jar <jar 文件 > [args...]
(执行 jar 文件)
或 java [options] -m < 模块 >[/< 主类 >] [args...]
java [options] --module < 模块 >[/< 主类 >] [args...]
(执行模块中的主类)
或 java [options] < 源文件 > [args]
(执行单个源文件程序)
将主类、源文件、-jar <jar 文件 >、-m 或
--module < 模块 >/< 主类 > 后的参数作为参数
传递到主类。
其中,选项包括:
-cp < 目录和 zip/jar 文件的类搜索路径 >
-classpath < 目录和 zip/jar 文件的类搜索路径 >
--class-path < 目录和 zip/jar 文件的类搜索路径 >
使用 ; 分隔的, 用于搜索类文件的目录, JAR 档案
和 ZIP 档案列表。
-p < 模块路径 >
--module-path < 模块路径 >...
用 ; 分隔的目录列表, 每个目录
都是一个包含模块的目录。
--upgrade-module-path < 模块路径 >...
用 ; 分隔的目录列表, 每个目录
都是一个包含模块的目录, 这些模块
用于替换运行时映像中的可升级模块
--add-modules < 模块名称 >[,< 模块名称 >...]
除了初始模块之外要解析的根模块。
< 模块名称 > 还可以为 ALL-DEFAULT, ALL-SYSTEM,
ALL-MODULE-PATH.
--list-modules
列出可观察模块并退出
-d <module name>
--describe-module < 模块名称 >
描述模块并退出
--dry-run 创建 VM 并加载主类, 但不执行 main 方法。
此 --dry-run 选项对于验证诸如
模块系统配置这样的命令行选项可能非常有用。
--validate-modules
验证所有模块并退出
--validate-modules 选项对于查找
模块路径中模块的冲突及其他错误可能非常有用。
-D< 名称 >=< 值 >
设置系统属性
-verbose:[class|module|gc|jni]
启用详细输出
-version 将产品版本输出到错误流并退出
--version 将产品版本输出到输出流并退出
-showversion 将产品版本输出到错误流并继续
--show-version
将产品版本输出到输出流并继续
--show-module-resolution
在启动过程中显示模块解析输出
-? -h -help
将此帮助消息输出到错误流
--help 将此帮助消息输出到输出流
-X 将额外选项的帮助输出到错误流
--help-extra 将额外选项的帮助输出到输出流
-ea[:< 程序包名称 >...|:< 类名 >]
-enableassertions[:< 程序包名称 >...|:< 类名 >]
按指定的粒度启用断言
-da[:< 程序包名称 >...|:< 类名 >]
-disableassertions[:< 程序包名称 >...|:< 类名 >]
按指定的粒度禁用断言
-esa | -enablesystemassertions
启用系统断言
-dsa | -disablesystemassertions
禁用系统断言
-agentlib:< 库名 >[=< 选项 >]
加载本机代理库 < 库名 >, 例如 -agentlib:jdwp
另请参阅 -agentlib:jdwp=help
-agentpath:< 路径名 >[=< 选项 >]
按完整路径名加载本机代理库
-javaagent:<jar 路径 >[=< 选项 >]
加载 Java 编程语言代理, 请参阅 java.lang.instrument
-splash:< 图像路径 >
使用指定的图像显示启动屏幕
自动支持和使用 HiDPI 缩放图像
(如果可用)。应始终将未缩放的图像文件名 (例如, image.ext)
作为参数传递给 -splash 选项 。
将自动选取提供的最合适的缩放
图像。
有关详细信息, 请参阅 SplashScreen API 文档
@argument 文件
一个或多个包含选项的参数文件
-disable-@files
阻止进一步扩展参数文件
--enable-preview
允许类依赖于此发行版的预览功能
要为长选项指定参数, 可以使用 --< 名称 >=< 值 > 或
--< 名称 > < 值 >。
补充内容: -server 与 -client
Hotspot JVM 有两种模式,分别是 server 和 client,分别通过 -server 和 -client 模式设置
- 32 位系统上,默认使用 Client 类型的 JVM。要想使用 Server 模式,机器配置至少有 2 个以上的 CPU 和 2G 以上的物理内存。client
模式适用于对内存要求较小的桌面应用程序,默认使用 Serial 串行垃圾收集器 - 64 位系统上,只支持 server 模式的 JVM,适用于需要大内存的应用程序,默认使用并行垃圾收集器
官网地址:https://docs.oracle.com/javase/8/docs/technotes/guides/vm/server-class.html
类型二:-X 参数选项
特点:
- 非标 准化参数
- 功能还是比较稳定的。但官方说后续版本可能会变更
- 以
-X开头
直接在 DOS 窗口中运行 java -X 命令可以看到所有的 X 选项
- JDK 8
- JDK 21
D:\Java\jdk-1.8\bin>java -version
java version "1.8.0_381"
Java(TM) SE Runtime Environment (build 1.8.0_381-b09)
Java HotSpot(TM) 64-Bit Server VM (build 25.381-b09, mixed mode)
D:\Java\jdk-1.8\bin>java -X
-Xmixed 混合模式执行(默认)
-Xint 仅解释模式执行
-Xbootclasspath:< 用 ; 分隔的目录和 zip/jar 文件 >
设置引导类和资源的搜索路径
-Xbootclasspath/a:< 用 ; 分隔的目录和 zip/jar 文件 >
附加在引导类路径末尾
-Xbootclasspath/p:< 用 ; 分隔的目录和 zip/jar 文件 >
置于引导类路径之前
-Xdiag 显示附加诊断消息
-Xnoclassgc 禁用类垃圾收集
-Xincgc 启用增量垃圾收集
-Xloggc:<file> 将 GC 状态记录在文件中(带时间戳)
-Xbatch 禁用后台编译
-Xms<size> 设置初始 Java 堆大小
-Xmx<size> 设置最大 Java 堆大小
-Xss<size> 设置 Java 线程堆栈大小
-Xprof 输出 cpu 分析数据
-Xfuture 启用最严格的检查,预计会成为将来的默认值
-Xrs 减少 Java/VM 对操作系统信号的使用(请参阅文档)
-Xcheck:jni 对 JNI 函数执行其他检查
-Xshare:off 不尝试使用共享类数据
-Xshare:auto 在可能的情况下使用共享类数据(默认)
-Xshare:on 要求使用共享类数据,否则将失败。
-XshowSettings 显示所有设置并继续
-XshowSettings:system
(仅限 Linux)显示系统或容器
配置并继续
-XshowSettings:all
显示所有设置并继续
-XshowSettings:vm 显示所有与 vm 相关的设置并继续
-XshowSettings:properties
显示所有属性设置并继续
-XshowSettings:locale
显示所有与区域设置相关的设置并继续
-X 选项是非标准选项。如有更改,恕不另行通知。
D:\Java\jdk-21.0.2\bin>java -X
-Xbatch 禁用后台编译
-Xbootclasspath/a:< 以 ; 分隔的目录和 zip/jar 文件 >
附加在引导类路径末尾
-Xcheck:jni 对 JNI 函数执行其他检查
-Xcomp 强制在首次调用时编译方法
-Xdebug 不执行任何操作;已过时,将在未来发行版中删除。
-Xdiag 显示附加诊断消息
-Xfuture 启用最严格的检查,预期将来的默认值。
此选项已过时,可能会在
未来发行版中删除。
-Xint 仅解释模式执行
-Xinternalversion
显示比 -version 选项更详细的
JVM 版本信息
-Xlog:<opts> 配置或启用采用 Java 虚拟
机 (Java Virtual Machine, JVM) 统一记录框架进行事件记录。使用 -Xlog:help
可了解详细信息。
-Xloggc:<file> 将 GC 状态记录在文件中(带时间戳)。
此选项已过时,可能会在
将来的发行版中删除。它将替换为 -Xlog:gc:<file>。
-Xmixed 混合模式执行(默认值)
-Xmn<size> 为年轻代(新生代)设置初始和最大堆大小
(以字节为单位)
-Xms<size> 设置初始 Java 堆大小
-Xmx<size> 设置最大 Java 堆大小
-Xnoclassgc 禁用类垃圾收集
-Xrs 减少 Java/VM 对操作系统信号的使用(请参见文档)
-Xshare:auto 在可能的情况下使用共享类数据(默认值)
-Xshare:off 不尝试使用共享类数据
-Xshare:on 要求使用共享类数据,否则将失败。
这是一个测试选项,可能导致间歇性
故障。不应在生产环境中使用 它。
-XshowSettings 显示所有设置并继续
-XshowSettings:all
显示所有设置并继续
-XshowSettings:locale
显示所有与区域设置相关的设置并继续
-XshowSettings:properties
显示所有属性设置并继续
-XshowSettings:vm
显示所有与 vm 相关的设置并继续
-XshowSettings:security
显示所有安全设置并继续
-XshowSettings:security:all
显示所有安全设置并继续
-XshowSettings:security:properties
显示安全属性并继续
-XshowSettings:security:providers
显示静态安全提供方设置并继续
-XshowSettings:security:tls
显示与 TLS 相关的安全设置并继续
-XshowSettings:system
(仅 Linux)显示主机系统或容器
配置并继续
-Xss<size> 设置 Java 线程堆栈大小
实际大小可以舍入到
操作系统要求的系统页面大小的倍数。
-Xverify 设置字节码验证器的模式
请注意,选项 -Xverify:none 已过时,
可能会在未来发行版中删除。
--add-reads <module>=<target-module>(,<target-module>)*
更新 <module> 以读取 <target-module>,而无论
模块如何声明。
<target-module> 可以是 ALL-UNNAMED,将读取所有未命名
模块。
--add-exports <module>/<package>=<target-module>(,<target-module>)*
更新 <module> 以将 <package> 导出到 <target-module>,
而无论模块如何声明。
<target-module> 可以是 ALL-UNNAMED,将导出到所有
未命名模块。
--add-opens <module>/<package>=<target-module>(,<target-module>)*
更新 <module> 以在 <target-module> 中打开
<package>,而无论模块如何声明。
--limit-modules <module name>[,<module name>...]
限制可观察模块的领域
--patch-module <module>=<file>(;<file>)*
使用 JAR 文件或目录中的类和资源
覆盖或增强模块。
--source <version>
设置源文件模式中源的版本。
--finalization=<value>
控 制 JVM 是否执行对象最终处理,
其中 <value> 为 "enabled" 或 "disabled" 之一。
默认情况下,最终处理处于启用状态。
这些额外选项如有更改, 恕不另行通知。
笔记
对比 JDK 8 和 JDK 21 变化还是很大的。
JVM 的 JIT 编译模式相关的选项
-Xint: 只使用解释器:所有字节码都 被解释执行,这个模式的速度是很慢的-Xcomp: 只使用编译器:所有字节码第一次使用就被编译成本地代码,然后在执行-Xmixed: 混合模式:这是默认模式,刚开始的时候使用解释器慢慢解释执行,后来让 JIT
即时编译器根据程序运行的情况,有选择地将某些热点代码提前编译并缓存在本地,在执行的时候效率就非常高了


JDK 默认使用的是混合模式
类型三:-XX 参数选项
特点:
- 非标准化参数
- 使用的最多的参数类型
- 这类选项属于实验性,不稳定
- 以
-XX开头
作用:用于开发和调试 JVM
Boolean 类型格式
-XX:+<option>表示启用 option 属性-XX:-<option>表示禁用 option 属性
举例
-XX:+UsePara1lelGC选择垃圾收集器为并行收集器-XX:+UseG1GC表示启用 G1 收集器-XX:+UseAdaptiveSizePolicy自动选择年轻代区大小和相应的 Survivor 区比例
非 Boolean 类型格式(key-value 类型)