Java平台，标准版工具参考/Java应用启动参数

时间 2019-11-10

标签 java 平台标准工具参考应用启动参数栏目 Java 繁體版

原文原文链接

官方原文: https://docs.oracle.com/javase/8/docs/technotes/tools/windows/java.html

不少都是谷歌翻译过来的,看不懂去看官方文档和百度

使用和阅读须知:

1. 因为部分机器翻译缘故,部分指令有中文符号与空格.使用时请注意替换符号与空格

2.本篇文章基于Java SE 8

3.本文章翻译子windows系统下的参数系列,由于笔者的学习环境基于windows,其余

系统平台请自行参考:

linux: https://docs.oracle.com/javase/8/docs/technotes/tools/unix/java.html

Java Platform, Standard Edition (Java SE) 8 : https://docs.oracle.com/javase/8/

概要

 
        java [options] classname [args]
java [options] -jar文件名[args]
javaw [options] classname [args]
javaw [options] -jar filename [args] 
       

选项

  命令行选项由空格分隔。参阅选项。

类名

  要启动的类的名称。

文件名

  要调用的Java归档（JAR）文件的名称。仅与-jar选项一块儿使用。

ARGS

  传递给main（）方法的参数用空格分隔。

描述

java命令启动一个Java应用程序。它经过启动Java运行时环境（JRE），加载指定的类并调用该类的main（）方法来实现此目的。该方法必须声明为public和static，它不能返回任何值，而且它必须接受一个String数组做为参数。方法声明具备如下形式：

public static void main(String [] args)

经过加载具备main()方法或扩展javafx.application.Application的类，java命令可用于启动JavaFX应用程序。在后一种状况下，启动程序构造Application类的一个实例，调用其init（）方法，而后调用start(javafx.stage.Stage)方法。

默认状况下，不是java命令选项的第一个参数是要调用的类的全限定名。若是指定了-jar选项，则其参数是包含应用程序的类和资源文件的JAR文件的名称。启动类必须在其源代码中由Main-Class清单标题指示。

JRE在三个位置中搜索启动类（以及应用程序使用的其余类）：引导类路径(bootstrap class path)，已安装的扩展(installed extensions)和用户的类路径(user's class path.)。[注]对应3个类加载器

类文件名或JAR文件名后面的参数传递给main()方法。

javaw命令与java相同，只是在javaw中没有关联的控制台窗口。若是不但愿显示命令提示符窗口，请使用javaw。可是，若是启动失败，javaw启动程序将显示一个包含错误信息的对话框。

选项

java命令支持普遍的选项，能够分为如下几类：

1.标准选项(Standard Options)

2.非标准选项(Non-Standard Options)

3.高级运行时选项(Advanced Runtime Options)

4.高级JIT编译器选项(Advanced JIT Compiler Options)

5.高级可维护选项(Advanced Serviceability Options)

6.高级垃圾收集选项(Advanced Garbage Collection Options)

Java虚拟机（JVM）的全部实现都支持标准选项。它们用于常见操做，例如检查JRE的版本，设置类路径，启用详细输出等。

非标准选项是特定于Java HotSpot虚拟机的通用选项，所以它们不保证被全部JVM实现支持，而且可能会有变化。这些选项以-X开头。

高级选项不建议随意使用。这些是用于调整Java HotSpot虚拟机操做的特定区域的开发人员选项，这些操做一般具备特定的系统要求，而且可能须要对系统配置参数进行特权访问。它们也不能保证被全部JVM实现支持，而且可能会发生变化。高级选项以-XX开头。

要跟踪最新版本中不推荐使用或删除的选项，在文档末尾会有一个名为“已弃用和已除去选项”的部分。

boolean选项用于启用默认禁用的功能或禁用默认启用的功能。这些选项不须要参数。boolean-XX选项使用加号(-XX:+ OptionName)启用，并使用减号(-XX:-OptionName)禁用。

对于须要参数的选项，参数能够经过空格，冒号(:)或等号(=)与选项名称分开，或者参数能够直接跟随选项（每一个选项的确切语法不一样）。若是您但愿以字节为单位指定大小，则能够不使用后缀，也可使用后缀k或K表示千字节（KB），m或M表示兆字节（MB），g或G表示千兆字节（GB）。例如，要将大小设置为8 GB，能够指定8g，8192m，8388608k或8589934592做为参数。若是您但愿指定百分比，请使用从0到1的数字（例如，指定0.25当作25％）。

标准选项(Standard Options)

这些是全部JVM实现都支持的最经常使用选项。

-agentlib:libname[=options]

加载指定的本地代理程序库。库名以后，可使用特定于库的逗号分隔列表选项。

若是指定了选项-agentlib：foo，则JVM将尝试在PATH系统变量指定的位置加载名为foo.dll的库。

如下示例显示了如何加载堆分析工具（HPROF）库，并每隔20 ms获取一个简单CPU信息，栈深度为3:

-agentlib:hprof=cpu=samples,interval=20,depth=3

如下示例显示如何加载 Java Debug Wire Protocol （JDWP）库并监听端口8000上的socket链接，并在加载主类以前挂起JVM：

-agentlib:jdwp=transport=dt_socket,server=y,address=8000

有关本地代理库的更多信息，请参阅如下内容：

http://docs.oracle.com/javase/8/docs/api/java/lang/instrument/package-summary.html 中的java.lang.instrument包描述

JVM工具界面指南中的代理程序命令行选项，位于 http://docs.oracle.com/javase/8/docs/platform/jvmti/jvmti.html#starting

agentpath:pathname[=options]

加载由绝对路径名指定的本地代理程序库。此选项等同于-agentlib，但要使用库的完整路径和文件名。

-client

选择Java HotSpot客户端VM。 Java SE开发工具包（JDK）的64位版本目前忽略此选项，而是使用Server VM。

有关默认JVM选择，请参阅Server-Class Machine Detection : http://docs.oracle.com/javase/8/docs/technotes/guides/vm/server-class.html

-Dproperty=value

设置系统属性值。该属性变量是一个不带空格的字符串，表示该属性的名称。值变量是一个表示属性值的字符串。若是value是一个带空格的字符串，则将其用引号引发来（例如-Dfoo="foo bar"）。

-disableassertions[:[packagename]...|:classname]/-da[:[packagename]...|:classname]

禁用断言。默认状况下，全部包和类中的断言都是禁用的。

若是没有参数，-disableassertions（-da）将禁用全部包和类中的声明。在packagename参数以...结尾的状况下，将禁用指定包和任何子包中的断言。若是参数只是...，那么会禁用当前工做目录中未命名包中的断言。使用classname参数，交换机将禁用指定类中的断言。

-disableassertions（-da）选项适用于全部类加载器和系统类（它们没有类加载器）。这个规则有一个例外：若是该选项没有提供参数，那么它不适用于系统类。这样能够很容易地禁用除系统类之外的全部类中的断言。 -disablesystemassertions选项使您能够禁用全部系统类中的断言。

要显式启用特定包或类中的断言，请使用-enableassertions（-ea）选项。两个选项能够同时使用。例如，要在包com.wombat.fruitbat（和任何子包）中启用断言但在类com.wombat.fruitbat.Brickbat中禁用的状况下运行MyClass应用程序，请使用如下命令：

 java -ea：com.wombat.fruitbat ... -da：com.wombat.fruitbat.Brickbat MyClass

-enablesystemassertions/-esa

开启全部系统类断言

-help/-?

显示java命令的可用信息而不实际运行JVM。

-jar filename

执行封装在JAR文件中的程序。 filename参数是带有清单的JAR文件的名称，该清单包含Main-Class：classname形式的行，该行使用public static void main(String[] args)方法定义该类，该方法充当您的应用程序的起点。

当使用-jar选项时，指定的JAR文件是全部用户类的资源，而其余类路径设置将被忽略。

有关JAR文件的更多信息，请参阅如下资源：

1. https://docs.oracle.com/javase/8/docs/technotes/tools/windows/jar.html#BGBEJEEG

2. Java存档（JAR）文件指南，位于 http://docs.oracle.com/javase/8/docs/technotes/guides/jar/index.html

3. 课程：打包JAR文件中的程序 http://docs.oracle.com/javase/tutorial/deployment/jar/index.html

-javaagent:jarpath[=options]

加载指定的Java编程语言代理。有关检测Java应用程序的更多信息，请参阅

http://docs.oracle.com/javase/8/docs/api/java/lang/instrument/package-summary 上的Java API文档中的java.lang.instrument的包描述

-jre-restrict-search

版本搜索中包含用户私有的JRE。

-no-jre-restrict-search

从版本搜索中排除用户私有JRE。

-server

选择Java HotSpot Server VM。 64位版本的JDK仅支持服务器虚拟机，所以在这种状况下，该选项是隐含的。

有关默认JVM选择，请参阅服务器级机器检测 http://docs.oracle.com/javase/8/docs/technotes/guides/vm/server-class.html

-showversion

显示版本信息并继续执行应用程序。该选项等同于-version选项，只是后者指示JVM在显示版本信息后退出。

-splash:imgname

用imgname指定的图像显示启动画面。例如，要在启动应用程序时从images目录显示splash.gif文件，请使用如下选项：

-splash：img/splash.gif

-verbose:class

显示有关每一个加载的类的信息。

-verbose:GC

显示有关每一个垃圾收集（GC）事件的信息。

-verbose：JNI

显示有关使用本机方法和其余Java Native Interface（JNI）活动的信息。

-version

显示版本信息，而后退出。该选项等同于-showversion选项，只是后者在显示版本信息后不指示JVM退出。

-version:release

指定用于运行应用程序的发行版本。若是调用的java命令的版本不符合此规范，而且在系统上找到适当的实现，则将使用适当的实现。

release参数指定了确切的版本字符串，或者是由空格分隔的版本字符串和范围列表。版本字符串是版本号的开发人员指定，格式以下：1.x.0_u（其中x是主要版本号，u是更新版本号）。版本范围由版本字符串组成，后跟加号（+）以指定此版本或更高版本，或版本字符串的一部分，后跟星号（*）以指定具备匹配前缀的任何版本字符串。版本字符串和范围可使用逻辑OR组合的空间或与两个版本字符串/范围的逻辑AND组合的和符号（＆）组合。例如，若是运行类或JAR文件须要JRE 6u13（1.6.0_13）或从6u10（1.6.0_10）开始的任何JRE 6，请指定如下内容：

-version:- "1.6.0_13 1.6* & 1.6.0_10+"

仅当发布参数中有空格时，才须要引号。

对于JAR文件，首选项是在JAR文件清单中指定版本要求，而不是在命令行上。

非标准选项/Non-Standard Options

这些选项是特定于Java HotSpot虚拟机的通用选项。

-X(大写)

展现全部可用-X选项

-Xbatch

禁用后台编译.默认状况下，JVM将该方法编译为后台任务，在解释器模式下运行该方法，直到后台编译完成。 -Xbatch标志禁用后台编译，以便编译全部方法做为前台任务继续执行直至完成。

这个选项也至关于:

 
-XX:-BackgroundCompilation

-Xbootclasspath : path

指定由分号(;)分隔的目录，JAR文件和ZIP存档的列表，以搜索引导类文件。这些用于代替JDK中包含的引导类文件。

不要部署使用此选项的应用程序来覆盖rt.jar中的类，由于这违反了JRE二进制代码许可证。

-Xbootclasspath/a : path

指定由分号(;)分隔的目录，JAR文件和ZIP存档的列表，以附加到默认引导程序类路径的末尾。

不要部署使用此选项的应用程序来覆盖rt.jar中的类，由于这违反了JRE二进制代码许可证。

-Xbootclasspath/p : path

指定由分号(;)分隔的目录，JAR文件和ZIP存档的列表，以预先添加到默认引导程序类路径的前面。

不要部署使用此选项的应用程序来覆盖rt.jar中的类，由于这违反了JRE二进制代码许可证。

-Xcheck : jni

对Java Native Interface（JNI）函数执行其余检查。具体来讲，它在处理JNI请求以前验证传递给JNI函数的参数和运行时环境数据。遇到的任何无效数据都代表本机代码存在问题，在这种状况下，JVM将以没法恢复的错误终止。使用此选项时，预计性能会降低。

-Xcomp

在第一次调用时强制编译方法。默认状况下，客户端VM（-client）执行1,000个已解释的方法调用，服务器VM（-server）执行10,000个已解释的方法调用以收集有效编译的信息。指定-Xcomp选项会禁用已解释的方法调用，从而以牺牲效率为代价来提升编译性能。

您还可使用-XX：CompileThreshold选项在编译以前更改已解释的方法调用的数量。

表示全部字节码都首先被编译成本地代码，而后再执行。

JIT编译器的模式之一

-Xdebug

什么也没作。提供向后兼容性。

-Xdiag

显示其余诊断消息。

-Xfuture

启用严格的类文件格式检查，以强制与类文件格式规范紧密一致。鼓励开发人员在开发新代码时使用此标志，由于更严格的检查将成为将来版本中的默认值。

-Xint

以仅解释模式运行应用程序。禁用对本机代码的编译，而且解释器将执行全部字节码。暂时（JIT）编译器提供的性能优点在此模式下不存在。

表示禁用JIT，全部字节码都被解释执行，这个模式的速度最慢的。

JIT编译器的模式之一

-Xinternalversion

显示比-version选项更详细的JVM版本信息，而后退出。

-Xloggc:filename

设置应将重定向的GC事件信息重定向到的文件以进行日志记录。写入此文件的信息相似于-verbose：gc的输出，其中包含自每一个记录事件以前的第一个GC事件以来通过的时间。若是二者都使用相同的java命令，则-Xloggc选项会覆盖-verbose：gc。

例：

-Xloggc:garbage-collection.log

-Xmaxjitcodesize=size

指定JIT编译代码的最大代码高速缓存大小（以字节为单位）。附加字母k或K表示千字节，m或M表示兆字节，g或G表示千兆字节。默认的最大代码缓存大小为240 MB;

若是使用-XX:- TieredCompilation选项禁用分层编译，则默认大小为48 MB：

-Xmaxjitcodesize=240m

此选项等效于-XX：ReservedCodeCacheSize。

-Xmixed

除了热方法以外，解释器执行全部字节码，热方法被编译为本机代码。

默认模式，让JIT根据程序运行的状况，有选择地将经常使用代码编译成本地代码。(如:被大量循环的代码)

JIT编译器的模式之一

-Xmnsize

设置年轻代(花园?托儿所?nursery我不知道怎么翻译)的堆的初始和最大大小（以字节为单位）。附加字母k或K表示千字节，m或M表示兆字节，g或G表示千兆字节。

堆的年轻代区域用于新对象。 GC在该区域比在其余区域更频繁地进行。若是年轻一代的规模过小，那么将会进行大量的小型垃圾收集。若是大小太大，则只执行完整的垃圾收集，这可能须要很长时间才能完成。 Oracle建议您将年轻代的大小保持在整个堆大小的一半到四分之一之间。

如下示例显示如何使用各类单位将年轻代的初始和最大大小设置为256 MB：

 
    -Xmn256m
-Xmn262144k
-Xmn268435456

您可使用-XX : NewSize设置初始大小而使用-XX : MaxNewSize来设置最大大小，而不是-Xmn选项来设置年轻代的堆的初始大小和最大大小。

-Xmssize

设置堆的初始大小（以字节为单位）。该值必须是1024的倍数且大于1 MB。附加字母k或K表示千字节，m或M表示兆字节，g或G表示千兆字节。

如下示例显示如何使用各类单位将分配的内存大小设置为6 MB：

-Xms6291456
-Xms6144k
-Xms6m

若是未设置此选项，则初始大小将设置为为旧代和年轻代分配的大小的总和。可使用-Xmn选项或-XX：NewSize选项设置年轻代的堆的初始大小。

-Xmxsize

指定内存分配池的最大大小（以字节为单位），以字节为单位。该值必须是1024的倍数且大于2 MB。附加字母k或K表示千字节，m或M表示兆字节，g或G表示千兆字节。根据系统配置在运行时选择默认值。 对于服务器部署，-Xms和-Xmx一般设置为相同的值。请参阅 http://docs.oracle.com/javase/8/docs/technotes/guides/vm/gctuning/index.html 上的Java SE HotSpot虚拟机垃圾收集调整指南中的“人机工程学( Ergonomics)”部分。

如下示例显示如何使用各类单位将分配的内存的最大容许大小设置为80 MB：

 
        -Xmx83886080
-Xmx81920k
-Xmx80m 
       

-Xmx选项等效于-XX : MaxHeapSize。

-Xnoclassgc

禁用类的垃圾收集（GC）[Disables garbage collection (GC) of classes]。这能够节省一些GC时间，从而缩短应用程序运行期间的中断。

在启动时指定-Xnoclassgc时，应用程序中的类对象将在GC期间保持不变，并始终被视为实时。 这可能致使更多的内存被永久占用，若是不当心使用，将致使内存不足异常。

-Xprof

配置正在运行的程序并将分析数据发送到标准输出。此选项做为在程序开发中有用的实用程序提供，不适用于生产系统。

-Xrs

减小JVM对操做系统信号的使用。

关闭Hooks,经过在关闭时运行用户清理代码（例如关闭数据库链接）来启用Java应用程序的有序关闭，即便JVM忽然终止也是如此。

JVM监视控制台控制事件，以实现意外终止的关闭挂钩。具体来讲，JVM注册一个控制台控制处理程序，它启动shutdown-hook处理，并为CTRL_C_EVENT，CTRL_CLOSE_EVENT，CTRL_LOGOFF_EVENT和CTRL_SHUTDOWN_EVENT返回TRUE。

JVM使用相似的机制来实现转储线程堆栈的功能以进行调试。 JVM使用CTRL_BREAK_EVENT执行线程转储。

若是JVM做为服务运行（例如，做为Web服务器的servlet引擎），则它能够接收CTRL_LOGOFF_EVENT但不该启动关闭，由于操做系统实际上不会终止该进程。为避免可能的干扰，可使用-Xrs选项。 使用-Xrs选项时，JVM不会安装控制台控制处理程序，这意味着它不会监视或处理CTRL_C_EVENT，CTRL_CLOSE_EVENT，CTRL_LOGOFF_EVENT或CTRL_SHUTDOWN_EVENT。

指定-Xrs有两个后果：

Ctrl + Break线程转储不可用。

用户代码负责引导关闭挂钩运行，例如，在终止JVM时调用System.exit()。

-Xshare : mode

设置类数据共享（CDS）模式。此选项的可能模式参数包括如下内容：

auto

尽量使用CDS。这是Java HotSpot 32位客户端VM的默认值。

须要使用CDS。若是没法使用类数据共享，则打印错误消息并退出。

off

不要使用CDS。这是Java HotSpot 32位服务器VM，Java HotSpot 64位客户端VM和Java HotSpot 64位服务器VM的默认值。

dump

手动生成CDS存档。按照“设置类路径”中的说明指定应用程序类路径。

您应该使用每一个新的JDK版本从新生成CDS存档。

-XshowSettings : category

显示设置并继续。此选项的可能类别参数包括如下内容：

all

显示全部类别的设置。这是默认值。

locale

显示与区域设置相关的设置。

properties

显示与系统属性相关的设置。

显示JVM的设置。

配置正在运行的程序并将分析数据发送到标准输出。此选项做为在程序开发中有用的实用程序提供，不适用于生产系统。

-Xsssize

设置线程堆栈大小（以字节为单位）。附加字母k或K表示KB，m或M表示MB，g或G表示GB。默认值取决于虚拟内存。

如下示例以不一样为单位将线程堆栈大小设置为1024 KB：

 
        -Xss1m
-Xss1024k
-Xss1048576 
       

此选项等效于-XX:ThreadStackSize。

-Xverify：mode

设置字节码验证器的模式。字节码验证可确保正确造成类文件，并知足“Java虚拟机规范”中第4.10节“类文件验证”中列出的约束。

不要关闭验证，由于这会减小Java提供的保护，并可能因为格式错误的类文件而致使问题。

类加载:加载-验证-准备-解析-初始化,这里是其中一个阶段:验证阶段

此选项的可能模式参数包括如下内容：

remote

  验证引导类加载器未加载的全部字节码。若是未指定-Xverify选项，则这是默认行为。

all

  启用全部字节码的验证。

none

  禁用全部字节码的验证。使用-Xverify:none不受支持。

Advanced Runtime Options/高级运行时选项

这些选项控制Java HotSpot VM的运行时行为。

-XX:+CheckEndorsedAndExtDirs

若是Java命令使用endorsed-standards override机制或扩展机制，则启用该选项以防止Java命令运行Java应用程序。此选项经过检查如下内容来检查应用程序是否正在使用这些机制之一：

设置了java.ext.dirs或java.endorsed.dirs系统属性。

lib / endorsed目录存在且不为空。

lib / ext目录包含除JDK以外的任何JAR文件。

系统范围的特定于平台的扩展目录包含任何JAR文件。

-XX:+ DisableAttachMechanism

启用禁用容许工具链接到JVM的机制的选项。默认状况下，此选项被禁用，这意味着启用了附加机制，您可使用jcmd，jstack，jmap和jinfo等工具。

-XX:ErrorFile=filename

指定发生不可恢复的错误时写入错误数据的路径和文件名。默认状况下，此文件在当前工做目录中建立，并命名为hs_err_pidpid.log，其中pid是致使错误的进程的标识符。如下示例显示如何设置默认日志文件（请注意，进程的标识符指定为％p）：

 -XX:ErrorFile=/hs_err_pid%p.log

如下示例显示如何将错误日志文件设置为C：/log/java/java_error.log：

-XX：ErrorFile= C:/log/java/java_error.log

若是没法在指定目录中建立文件（因为空间不足，权限问题或其余问题），则会在操做系统的临时目录中建立该文件。临时目录由TMP环境变量的值指定;若是未定义该环境变量，则使用TEMP环境变量的值。

-XX:+FailOverToOldVerifier

当新类型检查程序失败时，启用对旧验证程序的自动故障转移。默认状况下，此选项被禁用，而且对于具备最新字节码版本的类，它将被忽略（即，视为已禁用）。您能够为具备旧版字节码的类启用它。

-XX:+FlightRecorder

容许在应用程序运行时使用Java Flight Recorder（JFR）。这是一个与-XX：+ UnlockCommercialFeatures选项配合使用的商业功能，以下所示：

java -XX:+UnlockCommercialFeatures -XX:+FlightRecorder

若是未提供此选项，则仍可经过提供相应的jcmd诊断命令在正在运行的JVM中启用Java Flight Recorder。

-XX:-FlightRecorder

在应用程序运行时禁用Java Flight Recorder（JFR）。这是一个与-XX:+ UnlockCommercialFeatures选项配合使用的商业功能，以下所示：

java -XX:+ UnlockCommercialFeatures -XX:-FlightRecorder

若是提供此选项，则没法在正在运行的JVM中启用Java Flight Recorder。

-XX:FlightRecorderOptions=parameter=value

设置控制JFR行为的参数。这是一个与-XX:+UnlockCommercialFeatures选项配合使用的商业功能。只有在启用JFR时（即指定了-XX:+FlightRecorder选项），才能使用此选项。

如下列表包含全部可用的JFR参数：

defaultrecording={true|false}

指定录制是连续背景录制仍是在有限时间内运行。默认状况下，此参数设置为false（录制在限定时间内运行）。要使录制连续运行，请将参数设置为true。

disk={true|false}

指定JFR是否应将连续记录写入磁盘。默认状况下，此参数设置为false（禁用连续录制到磁盘）。要启用它，请将参数设置为true，并设置defaultrecording = true。

dumponexitpath=path

指定是否应生成JFR数据的转储文件

dumponexit={true|false}

指定当JVM以受控方式终止时是否应生成JFR数据的转储文件。默认状况下，此参数设置为false（不会生成退出时的转储文件）。要启用它，请将参数设置为true，并设置defaultrecording = true。

转储文件将写入dumponexitpath参数定义的位置。

dumponexitpath=path

若是设置dumponexit = true参数，则指定JVM数据的转储文件的路径和名称，该数据是在受控方式JVM退出时建立的。仅当您还设置defaultrecording = true时，设置路径才有意义。

若是指定的路径是目录，则JVM会分配一个显示建立日期和时间的文件名。若是指定的路径包含文件名，而且该文件已存在，则JVM经过将日期和时间戳附加到指定的文件名来建立新文件。

globalbuffersize=size

指定用于数据保留的主内存总量（以字节为单位）。附加k或K，以KB为单位指定大小，m或M指定大小（MB，g或G）以指定大小（以GB为单位）。默认状况下，大小设置为462848字节。

loglevel={quiet|error|warning|info|debug|trace}

指定JFR写入日志文件的数据量。默认状况下，它设置为info。

maxage=time

指定要为默认录制保留的磁盘数据的最长期限。附加s指定以秒为单位的时间，m表示分钟，h表示小时，d表示天（例如，指定30秒表示30秒）。默认状况下，最大年龄设置为15分钟（15m）。

仅当您设置disk = true参数时，此参数才有效。

maxchunksize=size

指定记录中数据块的最大大小（以字节为单位）。附加k或K，以KB为单位指定大小，m或M指定大小（MB，g或G）以指定大小（以GB为单位）。默认状况下，数据块的最大大小设置为12 MB。

maxsize=size

指定要为默认记录保留的磁盘数据的最大大小（以字节为单位）。附加k或K，以KB为单位指定大小，m或M指定大小（MB，g或G）以指定大小（以GB为单位）。默认状况下，磁盘数据的最大大小不受限制，此参数设置为0。

仅当您设置disk = true参数时，此参数才有效。

repository=path

指定临时磁盘存储的存储库（目录）。默认状况下，使用系统的临时目录。

samplethreads={true|false}

指定是否启用线程采样。仅当采样事件与此参数一块儿启用时，才会进行线程采样。默认状况下，启用此参数。

settings=path

指定事件设置文件的路径和名称（类型为JFC）。默认状况下，使用default.jfc文件，该文件位于JAVA_HOME / jre / lib / jfr中。

stackdepth=depth

JFR的堆栈跟踪堆栈深度。默认状况下，深度设置为64个方法调用。最大值为2048，最小值为1。

threadbuffersize=size

指定每线程本地缓冲区大小（以字节为单位）。附加k或K，以KB为单位指定大小，m或M指定大小（MB，g或G）以指定大小（以GB为单位）。此参数的较高值容许更多数据收集而不会争用将其刷新到全局存储。它能够在线程丰富的环境中增长应用程序占用空间。默认状况下，本地缓冲区大小设置为5 KB。

您能够经过用逗号分隔多个参数的值来指定它们。例如，要指示JFR将连续记录写入磁盘，并将数据块的最大大小设置为10 MB，请指定如下内容：

-XX:FlightRecorderOptions=defaultrecording=true,disk=true,maxchunksize=10M

-XX:LargePageSizeInBytes=size

在Solaris上，设置用于Java堆的大页的最大大小（以字节为单位）。 size参数必须是2的幂（2,4,8,16，...）。附加字母k或K表示千字节，m或M表示兆字节，g或G表示千兆字节。默认状况下，大小设置为0，这意味着JVM会自动选择大页面的大小。

如下示例说明如何将大页面大小设置为4兆字节（MB）：

-XX:LargePageSizeInBytes=4m

-XX:MaxDirectMemorySize=size

设置New I/O（java.nio包）直接缓冲区分配的最大总大小（以字节为单位）。附加字母k或K表示千字节，m或M表示兆字节，g或G表示千兆字节。默认状况下，大小设置为0，这意味着JVM会自动选择NIO直接缓冲区分配的大小。

如下示例说明如何以不一样单位将NIO大小设置为1024 KB：

-XX:MaxDirectMemorySize=1m
-XX:MaxDirectMemorySize=1024k
-XX:MaxDirectMemorySize=1048576

-XX:NativeMemoryTracking=mode

指定用于跟踪JVM本机内存使用状况的模式。此选项的可能模式参数包括如下内容：

off

  不跟踪JVM本机内存使用状况。若是未指定-XX：NativeMemoryTracking选项，则这是默认行为。

summary

  仅跟踪JVM子系统的内存使用状况，例如Java堆，类，代码和线程。

detail

  除了跟踪JVM子系统的内存使用状况外，还能够跟踪各个CallSite，单个虚拟内存区域及其已提交区域的内存使用状况。

-XX:ObjectAlignmentInBytes=alignment

设置Java对象的内存对齐方式（以字节为单位）。默认状况下，该值设置为8个字节。指定的值应为2的幂，而且必须在8和256（含）的范围内。此选项可使用具备大Java堆大小的压缩指针。

堆大小限制（以字节为单位）计算以下：

4GB * ObjectAlignmentInBytes

注意：随着对齐值的增长，对象之间未使用的空间也会增长。所以，您可能没有意识到使用具备大型Java堆大小的压缩指针会带来任何好处。

-XX:OnError=string

设置自定义命令或一系列以分号分隔的命令，以便在发生不可恢复的错误时运行。若是字符串包含空格，则必须用引号括起来。

如下示例显示如何使用-XX：OnError选项运行userdump.exe实用程序，以便在出现没法恢复的错误时获取崩溃转储（％p指定当前进程）：

-XX:OnError="userdump.exe %p"

上面的示例假定在PATH环境变量中指定了userdump.exe实用程序的路径。

-XX:OnOutOfMemoryError=string

设置自定义命令或一系列以分号分隔的命令，以便在首次抛出OutOfMemoryError异常时运行。若是字符串包含空格，则必须用引号括起来。有关命令字符串的示例，请参阅-XX：OnError选项的说明。

-XX:+PerfDataSaveToFile

若是启用，则在Java应用程序退出时保存jstat（1）二进制数据。此二进制数据保存在名为hsperfdata_ <pid>的文件中，其中<pid>是您运行的Java应用程序的进程标识符。使用jstat显示此文件中包含的性能数据，以下所示：

jstat -class file:///<path>/hsperfdata_<pid>
jstat -gc file:///<path>/hsperfdata_<pid>

-XX:+PrintCommandLineFlags

容许打印出如今命令行上的符合人体工程学选择的JVM标志。了解JVM设置的人体工程学值（例如堆空间大小和选定的垃圾收集器）可能颇有用。默认状况下，禁用此选项而且不打印标志。

-XX:+PrintNMTStatistics

启用本机内存跟踪时，容许在JVM出口处打印收集的本机内存跟踪数据（请参阅--XX:NativeMemoryTracking）。默认状况下，禁用此选项而且不打印本机内存跟踪数据。

-XX:+RelaxAccessControlCheck

减小验证程序中访问控制检查的数量。默认状况下，此选项被禁用，对于具备最新字节码版本的类，它将被忽略（即，视为已禁用）。您能够为具备旧版字节码的类启用它。

-XX:+ResourceManagement

在应用程序的运行时期间启用资源管理。

这是一项商业功能，须要您还指定 -XX:+UnlockCommercialFeatures 选项，以下所示：

java -XX:+UnlockCommercialFeatures -XX:+ResourceManagement

-XX:ResourceManagementSampleInterval=value (milliseconds)

设置控制资源管理测量的采样间隔的参数，以毫秒为单位。

仅当启用资源管理（即指定了 -XX:+ResourceManagement 选项）时，才能使用此选项。

-XX:SharedArchiveFile=path

指定类数据共享（CDS）归档文件的路径和名称

-XX:SharedClassListFile=file_name

指定包含要存储在类数据共享（CDS）存档中的类文件名称的文本文件。此文件包含每行一个类文件的全名，斜杠（/）替换点（。）除外。例如，要指定类java.lang.Object和hello.Main，请建立一个包含如下两行的文本文件：

java/lang/Object
hello/Main

您在此文本文件中指定的类文件应包含应用程序经常使用的类。它们能够包括应用程序，扩展或引导类路径中的任何类。

-XX:+ShowMessageBoxOnError

当JVM遇到没法恢复的错误时，容许显示对话框。这能够防止JVM退出并使进程保持活动状态，以便您能够将调试器附加到它以调查错误缘由。默认状况下，禁用此选项。

-XX:StartFlightRecording=parameter=value

启动Java应用程序的JFR记录。这是一个与-XX:+UnlockCommercialFeatures选项配合使用的商业功能。此选项等同于在运行时期间启动记录的JFR.start诊断命令。您能够在开始JFR录制时设置如下参数：

compress={true|false}

  指定是否使用gzip文件压缩实用程序压缩磁盘上的JFR记录日志文件（JFR类型）。仅当指定了filename参数时，此参数才有效。默认状况下，它设置为false（记录未压缩）。要启用压缩，请将参数设置为true。

defaultrecording={true|false}

  指定录制是连续背景录制仍是在有限时间内运行。默认状况下，此参数设置为false（录制在限定时间内运行）。要使录制连续运行，请将参数设置为true。

delay=time

  指定Java应用程序启动时间和记录开始之间的延迟。附加s以秒为单位指定时间，m表示分钟，h表示小时，d表示天（例如，指定10米表示10分钟）。默认状况下，没有延迟，此参数设置为0。

dumponexit={true|false}

  指定当JVM以受控方式终止时是否应生成JFR数据的转储文件。默认状况下，此参数设置为false（不会生成退出时的转储文件）。要启用它，请将参数设置为true。

  转储文件将写入filename参数定义的位置。

  例：

-XX:StartFlightRecording=name=test,filename=D:\test.jfr,dumponexit=true

duration=time

  指定录制的持续时间。附加s以秒为单位指定时间，m表示分钟，h表示小时，d表示天（例如，指定5h表示5小时）。默认状况下，持续时间不受限制，此参数设置为0。

filename=path

  指定JFR记录日志文件的路径和名称。

name=identifier

  指定JFR记录的标识符。默认状况下，它设置为Recording x。

maxage=time

  指定要为默认录制保留的磁盘数据的最长期限。附加s指定以秒为单位的时间，m表示分钟，h表示小时，d表示天（例如，指定30秒表示30秒）。默认状况下，最大年龄设置为15分钟（15m）。

maxsize=size

  指定要为默认记录保留的磁盘数据的最大大小（以字节为单位）。附加k或K，以KB为单位指定大小，m或M指定大小（MB，g或G）以指定大小（以GB为单位）。默认状况下，磁盘数据的最大大小不受限制，此参数设置为0。

settings=path

  指定事件设置文件的路径和名称（类型为JFC）。默认状况下，使用default.jfc文件，该文件位于JAVA_HOME / jre / lib / jfr中。

您能够经过用逗号分隔多个参数的值来指定它们。例如，要将记录保存到当前工做目录中的test.jfr，并指示JFR压缩日志文件，请指定如下内容：

-XX:StartFlightRecording=filename=test.jfr,compress=true

-XX:ThreadStackSize=size

设置线程堆栈大小（以字节为单位）。附加字母k或K表示千字节，m或M表示兆字节，g或G表示千兆字节。默认值取决于虚拟内存。

如下示例显示如何以不一样单位将线程堆栈大小设置为1024 KB：

 
        -XX:ThreadStackSize=1m
-XX:ThreadStackSize=1024k
-XX:ThreadStackSize=1048576 
       

此选项等效于-Xss。

-XX:+TraceClassLoading

容许在加载类时跟踪类。默认状况下，禁用此选项而且不跟踪类。

-XX:+TraceClassLoadingPreorder

容许按引用顺序跟踪全部已加载的类。默认状况下，禁用此选项而且不跟踪类。

-XX:+TraceClassResolution

容许跟踪常量池分辨率。默认状况下，禁用此选项

-XX:+TraceClassUnloading

容许在卸载类时跟踪类。默认状况下，禁用此选项而且不跟踪类。

-XX:+TraceLoaderConstraints

容许跟踪加载器约束记录。默认状况下，禁用此选项而且不跟踪加载程序约束记录。

-XX:+UnlockCommercialFeatures

容许使用商业功能。商业功能包含在Oracle Java SE Advanced或Oracle Java SE Suite包中，如Java SE产品页面上所定义，网址为 http://www.oracle.com/technetwork/java/javase/terms/products/index.html

默认状况下，此选项被禁用，JVM在没有商业功能的状况下运行。一旦为JVM进程启用了它们，就没法禁用它们用于该进程。

若是未提供此选项，则仍可以使用相应的jcmd诊断命令在正在运行的JVM中解锁商业功能。

-XX:+UseAppCDS

启用应用程序类数据共享（AppCDS）。要使用AppCDS，还必须在CDS转储时间（请参阅-Xshare：dump选项）和应用程序运行时间期间指定选项-XX：SharedClassListFile和-XX：SharedArchiveFile的值。

这是一项商业功能，须要您还指定-XX:+UnlockCommercialFeatures选项。这也是一个实验性的特征;它可能在未来的版本中发生变化

-XX:-UseBiasedLocking

禁用使用偏置锁定。一些具备大量无竞争同步的应用程序能够在启用此标志的状况下得到显着的加速，而具备某些锁定模式的应用程序可能会看到减速。有关偏置锁定技术的更多信息，请参阅Java调优白皮书中的示例，网址为 http://www.oracle.com/technetwork/java/tuning-139912.html#section4.2.5

默认状况下，启用此选项。

-XX:-UseCompressedOops

禁用压缩指针的使用。默认状况下，启用此选项，并在Java堆大小小于32 GB时使用压缩指针。启用此选项时， 对象引用表示为32位偏移而不是64位指针，这一般会在运行Java堆大小小于32 GB的应用程序时提升性能。 此选项仅适用于64位JVM。

当Java堆大小大于32GB时，也可使用压缩指针。请参见-XX:ObjectAlignmentInBytes选项。

-XX:+UseLargePages

容许使用大页面内存。默认状况下，禁用此选项而且不使用大页面内存。

有关更多信息，请参阅 https://docs.oracle.com/javase/8/docs/technotes/tools/windows/java.html#large_pages 。

-XX:+UseMembar

容许在线程状态转换上发布membars。默认状况下，在除ARM服务器以外的全部平台上都禁用此选项。（建议您不要在ARM服务器上禁用此选项。）

-XX:+UsePerfData

启用perfdata功能。默认状况下启用此选项以容许JVM监视和性能测试。禁用它会禁止建立hsperfdata_userid目录。要禁用perfdata功能，请指定-XX：-UsePerfData。

-XX:+AllowUserSignalHandlers

容许应用程序安装信号处理程序。默认状况下，禁用此选项，而且不容许应用程序安装信号处理程序。

高级JIT编译器选项/Advanced JIT Compiler Options

这些选项控制Java HotSpot VM执行的动态即时（JIT）编译。

-XX:+AggressiveOpts

容许使用积极的性能优化功能，这些功能有望在即将发布的版本中成为默认功能。默认状况下，禁用此选项而且不使用实验性能功能。

-XX:AllocateInstancePrefetchLines=lines

设置在实例分配指针以前预取的行数。默认状况下，预取的行数设置为1：

-XX:AllocateInstancePrefetchLines=1