windos java war命令 javaw命令是什么意思

转载

mob64ca1411a6fc 2023-10-09 19:58:34

文章标签 windos java war命令 java jar 开发语言 jvm.gc 文章分类 Java 后端开发

java 工具的介绍

java - 启动java程序

简介

Windows: javaw命令与java相同，除了javaw没有相关的控制台窗口。当您不希望出现命令提示符窗口时，请使用javaw。然而，如果启动失败，javaw启动器将显示一个带有错误信息的对话框。

要启动一个类文件:

java [options] mainclass [args...]

要在JAR文件中启动主类:

java [options] -jar jarfile [args...]

要在模块中启动主类:

java [options] -m module[/mainclass] [args...]

或者

java [options] --module module[/mainclass] [args...]

要启动单个源文件程序:

java [options] source-file [args...]

[options] 可选项:命令行选项，以空格分隔。

mainclass 要启动的类名。classname后面的命令行条目是main方法的参数。

-jar jarfile 执行封装在JAR文件中的程序。jarfile参数是一个JAR文件的名称，其中的清单包含一行Main-Class:classname的形式，它用public static void main(String[] args)方法定义类，该方法作为应用程序的起点。使用-jar时，指定的JAR文件是所有用户类的源，其他类路径设置将被忽略。如果使用JAR文件，请参阅JAR命令。

-m 或 --module module[/mainclass]执行由mainclass指定的模块中的main类，如果它被指定，或者，如果它没有被指定，则在模块中执行。换句话说，mainclass可以在未由模块指定时使用，或者在指定时覆盖该值。

source-file 仅用于启动单个源文件程序。指定使用源文件模式时包含主类的源文件。

[args…] 可选项:mainclass、source-file、-jar jarfile和-m或–module module/mainclass后面的参数作为参数传递给main类。

描述

java命令用来启动java应用程序。它通过启动Java Runtime Environment、加载指定的类并调用该类的main()方法来实现这一点。该方法必须声明为公有和静态的，它不能返回任何值，并且必须接受String数组作为参数。方法声明的形式如下:

class HelloWorld {
    public static void main(String[] args) { }
}

在源文件模式下，java命令可以启动在源文件中声明的类。

默认情况下，不是java命令选项的第一个参数是要调用的类的完全限定名。如果指定了-jar，那么它的参数是包含应用程序的类和资源文件的JAR文件的名称。启动类必须由清单文件中的Main-Class清单头指示。

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

使用源文件模式启动单文件源代码程序

要启动在源文件中声明的类，请在源文件模式下运行java启动程序。进入源文件模式由java命令行上的两个项决定:

不是选项或选项的一部分的命令行上的第一项。换句话说，命令行中的项，否则它将是主类名。

如果存在–source版本选项。

如果类标识了具有.java扩展名的现有文件，或者指定了–source选项，则选择源文件模式。然后编译并运行源文件。–source选项可用于指定源代码版本或源代码的N。这决定了可以使用的API。当你设置–source N时，你只能使用JDK N中定义的公共API。

如果文件没有.java扩展名，则必须使用–source选项来告诉java命令使用源文件模式。当源文件是要执行的“脚本”，并且源文件的名称不遵循Java源文件的常规命名约定时，使用–source选项。

在源文件模式下，效果就好像源文件被编译到内存中，然后执行源文件中找到的第一个类。在原始命令行中，位于源文件名称之后的任何参数都在执行时传递给已编译类。

例如，如果一个名为HelloWorld.java的文件包含一个名为hello. java的类。，则启动类的源文件模式命令为:

java HelloWorld.java

这个示例说明了类可以在命名包中，而不需要在未命名包中。当hello.World是包中的类名，这种源文件模式的使用在非正式意义上等同于使用下面两个命令:

javac -d memory HelloWorld.java
java -cp memory hello.World

在源文件模式下，任何额外的命令行选项将按如下方式处理:

启动程序扫描源文件之前指定的选项，以便编译源文件。
这包括:–class-path，–module-path，–add-exports，–add-modules，–limit-modules，–patch-module，–upgrade-module-path，以及这些选项的任何变体形式。它还包括–enable-preview选项，在JEP 12:预览语言和虚拟机特性中描述。
没有规定向编译器传递任何附加选项，如-processor或-Werror。
命令行参数文件(@-files)可以以标准方式使用。VM或被调用程序的长参数列表可以放在命令行中指定的文件中，方法是在文件名前加上@字符。

在源文件模式下，编译过程如下:

所有与编译环境相关的命令行选项都要考虑在内。
没有找到其他源文件并进行编译，就好像源路径被设置为空值一样。
注释处理被禁用，就像-proc:none有效一样。
如果通过–source选项指定了版本，则该值将用作编译时隐式的–release选项的参数。这设置了编译器接受的源版本，以及源文件中的代码可能使用的系统API。
源文件在未命名模块的上下文中编译。
源文件应该包含一个或多个顶级类，其中第一个作为要执行的类。
编译器不会强制执行JLS§7.6末尾定义的可选限制，即命名包中的类型应该存在于文件名由类型名后跟.java扩展名组成的文件中。
如果源文件包含错误，则将适当的错误消息写入标准错误流，启动程序将以非零的退出代码退出。

在源文件模式下，执行如下:

要执行的类是在源文件中找到的第一个顶级类。它必须包含标准公共静态void main(String[])方法的声明。
编译后的类由自定义的类加载器加载，并委托给应用程序类加载器。这意味着出现在应用程序类路径上的类不能引用源文件中声明的任何类。
编译后的类在未命名模块的上下文中执行，就像–add-modules=ALL-DEFAULT生效一样。这是对命令行中可能指定的任何其他–add-module选项的补充。
命令行中出现在文件名之后的任何参数都以明显的方式传递给标准的main方法。
如果应用程序类路径上有一个类的名称与要执行的类的名称相同，则会出现错误。

使用JDK_JAVA_OPTIONS启动器环境变量

JDK_JAVA_OPTIONS 将其内容添加到从命令行解析的选项之前。JDK_JAVA_OPTIONS 环境变量的内容是一个由空格字符分隔的参数列表(由isspace()确定)。这些参数被附加到传递给java启动器的命令行参数之前。环境变量的编码要求与系统上的java命令行相同。JDK_JAVA_OPTIONS环境变量内容的处理方式与命令行中指定的方式相同。

单```或双"引号可以用来包围包含空白字符的参数。只要删除这对引号，就可以保留左引号和第一个匹配的右引号之间的所有内容。如果没有找到匹配的引号，启动程序将中止并返回错误消息。支持@-files，因为它们是在命令行中指定的。但是，与@-files一样，不支持使用通配符。为了减少JDK_JAVA_OPTIONS行为的潜在误用，在环境变量中不允许指定主类(如-jar)或导致java启动程序退出而不执行主类(如-h)的选项。如果这些选项中的任何一个出现在环境变量中，启动程序将中止并显示错误消息。当设置了JDK_JAVA_OPTIONS时，启动器将向stderr打印一条消息作为提醒。
例子：

export JDK_JAVA_OPTIONS='-g @file1 -Dprop=value @file2 -Dws.prop="white spaces"' 

java -Xint @file3

等价于命令行:

java -g @file1 -Dprop=value @file2 -Dws.prop="white spaces" -Xint @file3

Java选项概述

java命令支持以下类别中的广泛选项:

Java的标准选项:Java虚拟机(JVM)的所有实现保证支持的选项。它们用于常见的操作，例如检查JRE版本、设置类路径、启用详细输出等等。
Java的额外选项:特定于Java热点虚拟机的通用选项。它们不能保证得到所有JVM实现的支持，并且可能会发生变化。这些选项以-X开头。

不建议随意使用高级选项。这些是用于调优Java HotSpot Virtual Machine操作的特定领域的开发人员选项，这些操作通常有特定的系统需求，可能需要对系统配置参数的特权访问。性能调优示例中提供了几个性能调优示例。这些选项并不能保证得到所有JVM实现的支持，并且可能会发生变化。高级选项以-XX开头。

高级运行时选项:控制Java HotSpot虚拟机的运行时行为。
高级JIT编译器选项:控制Java HotSpot VM执行的动态JIT (just-in-time)编译。
高级可服务性选项:启用收集系统信息和执行广泛的调试。
高级垃圾收集选项:控制Java HotSpot如何执行垃圾收集(GC)
布尔选项用于启用默认禁用的特性或禁用默认启用的特性。这些选项不需要参数。Boolean -XX选项使用加号(-XX:+OptionName)启用，使用减号(-XX:-OptionName)禁用。

对于需要参数的选项，参数可以用空格、冒号(:)或等号(=)与选项名分开，或者参数可以直接跟在选项后面(每个选项的语法不同)。如果希望以字节为单位指定大小，那么可以不使用后缀，或者使用后缀k或k表示千字节(KB)， m或m表示兆字节(MB)， g或g表示千兆字节(GB)。例如，要将大小设置为8gb，可以指定8g、8192m、8388608k或8589934592作为参数。如果您希望指定百分比，则使用0到1之间的数字。例如，为25%指定0.25。

Java的标准选项

这些是JVM的所有实现都支持的最常用选项。

-agentlib:libname[=options] 加载指定的本地代理库。在库名之后，可以使用特定于该库的以逗号分隔的选项列表。

Linux和macOS:如果指定了-agentlib:foo选项，那么JVM将尝试加载名为libfoo的库。因此，在LD_LIBRARY_PATH系统变量指定的位置(在macOS上，这个变量是DYLD_LIBRARY_PATH)。
Windows:如果指定了选项-agentlib:foo，那么JVM将尝试在PATH系统变量指定的位置加载名为foo.dll的库。

下面的示例展示了如何加载Java Debug Wire Protocol (JDWP)库并侦听端口8000上的套接字连接，在主类加载之前挂起JVM:

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

-agentpath:pathname[=options] 加载由绝对路径名指定的本机代理库。该选项相当于-agentlib，但使用库的完整路径和文件名。

–class-path classpath， -classpath classpath，或-cp classpath用分号(;)分隔的目录、JAR存档和ZIP存档列表，用于搜索类文件。

指定类路径将覆盖classpath环境变量的任何设置。如果未使用类路径选项，且未设置类路径，则用户类路径由当前目录(.)组成。

作为一种特殊的便利，包含星号()基名的类路径元素被认为等同于指定扩展名为.jar或.JAR的目录中所有文件的列表。Java程序无法区分这两个调用之间的区别。例如，如果目录mydir包含a.jar和b.JAR，那么类路径元素mydir/将被展开为a.jar:b.JAR，只是JAR文件的顺序没有指定。指定目录下的所有.jar文件，甚至是隐藏的文件，都包含在列表中。由星号(*)组成的类路径条目展开为当前目录中所有jar文件的列表。定义的CLASSPATH环境变量以类似的方式展开。任何类路径通配符扩展都发生在Java VM启动之前。除非通过查询环境，例如通过调用System.getenv(“CLASSPATH”)，Java程序永远不会看到不展开的通配符。
–disable-@files 可以在命令行中的任何地方使用，包括在参数文件中，以防止@filename进一步展开。该选项在选项之后停止展开@-argfiles。

–enable-preview 允许类依赖于发布版的预览特性。

–module-path modulepath… 或-p modulepath 用分号(;)分隔的目录列表，其中每个目录是模块目录。

–upgrade-module-path modulepath……用分号(;)分隔的目录列表，其中每个目录都是替换运行时映像中可升级模块的模块目录。

–add-modules module[,module…] 指定要解析的根模块和初始模块。module也可以是ALL-DEFAULT、ALL-SYSTEM和ALL-MODULE-PATH。

–list-modules 列出可观察模块然后退出。

-d module-name或–description -module module-name 描述指定的模块，然后退出。

–dry-run 创建VM，但不执行main方法。这个–dry-run选项可能对验证命令行选项(如模块系统配置)很有用。

–validate-modules 验证所有模块并退出。此选项有助于查找模块路径上的模块冲突和其他错误。

-Dproperty=value 设置系统属性值。属性变量是一个不带空格的字符串，表示属性的名称。value变量是一个表示属性值的字符串。如果value是一个带空格的字符串，则用引号将其括起来(例如-Dfoo=“foo bar”)。

-disableassertions[:[packagename]…|:classname] 或 -da[:[packagename]…|:classname] 禁用断言。默认情况下，断言在所有包和类中都禁用。如果没有参数，-disableassertions (-da)将禁用所有包和类中的断言。packagename参数以…结尾，该开关禁用指定包和任何子包中的断言。如果这个参数是简单的…，则开关禁用当前工作目录中的未命名包中的断言。使用classname参数，开关禁用指定类中的断言。

-disableassertions (-da) 选项适用于所有类加载器和系统类(没有类加载器)。这条规则有一个例外:如果选项没有提供参数，那么它就不适用于系统类。这使得在除系统类之外的所有类中禁用断言变得很容易。选项-disablesystemassertions允许在所有系统类中禁用断言。要显式地在特定的包或类中启用断言，使用-enableassertions (-ea)选项。这两个选项可以同时使用。例如，要运行MyClass应用程序，在包com.wombat.fruitbat(和任何子包)中启用断言，但在类com.wombat.fruitbat.Brickbat中禁用断言，使用以下命令:

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

-disablesystemassertion 或-dsa在所有系统类中禁用断言。

-enableassertions[:[packagename]…|:classname] 或-ea[:[packagename]…|:classname] 开启断言。默认情况下，断言在所有包和类中都禁用。如果没有参数，-enableassertions (-ea)会在所有包和类中启用断言。packagename参数以…结尾，该开关启用指定包和任何子包中的断言。如果这个论点是简单的…，则该开关启用当前工作目录中的未命名包中的断言。使用classname参数，该开关启用指定类中的断言。

-enableassertions (-ea)选项适用于所有类加载器和系统类(没有类装入器)。这条规则有一个例外:如果选项没有提供参数，那么它就不适用于系统类。这使得在除系统类之外的所有类中启用断言变得很容易。

选项-enablesystemassertions提供了一个单独的开关，用来在所有系统类中启用断言。要显式禁用特定包或类中的断言，请使用-disableassertions (-da)选项。如果一个命令包含这些开关的多个实例，那么在加载任何类之前，将按顺序处理它们。例如，要运行只在包com.wombat.fruitbat(和任何子包)中启用断言而在类com.wombat.fruitbat中禁用断言的MyClass应用程序，使用以下命令:

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

-enablesystemassertion或-esa在所有系统类中启用断言。

-help， -h还是-?将帮助消息打印到错误流。

–help将帮助消息打印到输出流。

-javaagent:jarpath[=options]加载指定的Java编程语言代理。

–show-version将产品版本打印到输出流并继续。

-showversion将产品版本打印到错误流并继续。

–show-module-resolution显示启动时模块分辨率输出。

-splash:imagepath显示带有imagepath指定的图像的启动画面。HiDPI缩放图像自动支持和使用，如果可用。未缩放的图像文件名，如image.Ext，应该始终作为参数传递给-splash选项。所提供的最合适的缩放图像将自动提取。

例如，要在启动应用程序时显示images目录中的splash.gif文件，请使用以下选项:

-splash:images/splash.gif

-verbose:class显示每个加载的类的信息。

-verbose:gc显示每个gc (garbage collection)事件的信息。

-verbose:jni显示本机方法和其他Java本机接口(jni)活动的使用信息。

-verbose:module显示正在使用的模块信息。

–version将产品版本打印到错误流并退出。

-version将产品版本打印到输出流并退出。

-X打印错误流中额外选项的帮助。

–help-extra将额外选项的帮助打印到输出流。

@argfile java命令使用的一个或多个以@为前缀的参数文件。java命令行由于类路径中需要.jar文件而变得很长，这种情况并不少见。@argfile选项通过允许启动程序在shell展开之后但在参数处理之前展开参数文件的内容，克服了命令行长度的限制。参数文件中的内容将被展开，因为否则，它们将在命令行上指定，直到遇到-Xdisable-@files选项。

参数文件还可以包含主类名和所有选项。如果一个参数文件包含java命令所需的所有选项，那么命令行可以简单地为:

java @argfile

Java命令的额外选项

以下java选项是特定于java HotSpot虚拟机的通用选项。

-Xbatch 禁用后台编译。默认情况下，JVM将方法编译为后台任务，在解释器模式下运行方法，直到后台编译完成。xbatch标志禁用后台编译，以便所有方法的编译都作为前台任务进行，直到完成为止。这个选项相当于-XX:-BackgroundCompilation。

-Xbootclasspath/a:directories|zip|JAR-files指定附加到默认引导类路径末尾的目录、JAR文件和zip归档文件列表。

Linux和macOS:用冒号(:)分隔列表中的实体。
Windows:分号(;)分隔列表中的实体。

-Xcheck:jni 对jni (Java Native Interface)函数执行额外的检查。具体来说，它在处理JNI请求之前验证传递给JNI函数的参数和运行时环境数据。它还检查JNI调用之间的挂起异常。遇到的任何无效数据都表明本机代码中存在问题，在这种情况下，JVM会以不可恢复的错误终止。使用此选项时，性能可能会下降。

-Xcomp强制方法在第一次调用时进行编译。默认情况下，Client VM (-client)执行1000次解释方法调用，Server VM (-server)执行10000次解释方法调用以收集信息以进行有效编译。指定-Xcomp选项将禁用解释方法调用，以牺牲效率来提高编译性能。您还可以使用-XX:CompileThreshold选项更改编译前解释方法调用的数量。

xdebug 什么也不做。提供向后兼容性。

-Xdiag 显示其他诊断消息。

-Xfuture 启用严格的类文件格式检查，强制严格遵守类文件格式规范。开发人员在开发新代码时应该使用这个标志。在未来的版本中，更严格的检查可能会成为默认做法。

-Xint 以仅解释模式运行应用程序。对本机代码的编译被禁用，所有字节码都由解释器执行。在这种模式下，即时(JIT)编译器提供的性能优势不存在。

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

-Xloggc:option 启用JVM统一日志框架。将GC状态记录到一个带有时间戳的文件中。

-Xlog:option 使用Java虚拟机(JVM)统一日志框架配置或启用日志。请参见使用JVM统一日志框架启用日志记录。

-Xmixed 执行解释器除热方法外的所有字节码，热方法被编译为本机代码。

-Xmn size设置年轻代(托儿所)堆的初始大小和最大大小(以字节为单位)。加上字母k或K表示千字节，m或M表示兆字节，g或G表示千兆字节。堆的年轻代区域用于新对象。与其他区域相比，该区域执行GC的频率更高。如果年轻代的大小太小，那么将执行大量次要垃圾收集。如果大小太大，则只执行完整的垃圾收集，这可能需要很长时间才能完成。

Oracle建议将年轻代的大小保持在总体堆大小的25%和50%以下。下面的示例演示如何使用不同的单位将年轻代的初始大小和最大大小设置为256mb:

-Xmn256m
-Xmn262144k
-Xmn268435456

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

-Xms size 设置堆的最小和初始大小(以字节为单位)。该值必须为1024的倍数，且大于1MB。加上字母k或K表示千字节，m或M表示兆字节，g或G表示千兆字节。下面的例子展示了如何使用不同的单位将分配的内存大小设置为6MB:

-Xms6291456
-Xms6144k
-Xms6m

如果不设置此选项，则初始大小将被设置为为老年代和年轻代分配的大小的总和。年轻代的初始堆大小可以通过使用-Xmn选项或-XX:NewSize选项设置

-Xmx size 内存分配池的最大大小，单位为字节。k或K表示千字节，m或M表示兆字节，g或G表示千兆字节。默认值是在运行时根据系统配置选择的。对于服务器部署，-Xms和-Xmx通常设置为相同的值。下面的例子展示了如何使用不同的单位设置最大允许分配的内存大小为80MB:

-Xmx83886080
-Xmx81920k
-Xmx80m

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

-Xnoclassgc 禁用类的垃圾回收。这可以节省一些GC时间，从而缩短应用程序运行期间的中断。当您在启动时指定-Xnoclassgc时，应用程序中的类对象将在GC期间保持不变，并始终被认为是活动的。这可能导致更多内存被永久占用，如果不小心使用，就会抛出内存不足异常。

-Xrs 减少JVM对操作系统信号的使用。关闭钩子允许在关闭时运行用户清理代码(例如关闭数据库连接)，即使JVM突然终止，也可以有序地关闭Java应用程序。

Linux和macOS:
JVM捕获信号以实现意外终止的关闭钩子。JVM使用SIGHUP、SIGINT和SIGTERM来启动关闭钩子的运行。
嵌入JVM的应用程序经常需要捕获信号，如SIGINT或SIGTERM，这可能导致对JVM信号处理程序的干扰。可以使用-Xrs选项来解决这个问题。当使用-Xrs时，JVM不会更改SIGINT、SIGTERM、SIGHUP和SIGQUIT的信号掩码，也不会安装这些信号的信号处理程序。
Windows:
JVM监视控制台控制事件，以实现意外终止的关闭钩子。具体地说，JVM注册一个控制台控制处理程序，它开始处理关闭钩子并对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有两个结果:

Linux和macOS: SIGQUIT线程转储不可用。
Windows: Ctrl + Break线程转储不可用。
用户代码负责导致关闭钩子运行，例如，在JVM要终止时调用System.exit()。

-Xshare:mode 设置类数据共享(CDS)模式。

此选项的可能模式参数包括:

auto 如果可能的话使用CDS 。这是Java HotSpot 32位客户端虚拟机的默认值。

on 要求使用CDS。如果不能使用类数据共享，此选项将打印错误消息并退出。

off 指示不要使用CDS 。

-XshowSettings 显示所有设置，然后继续。

-XshowSettings:category 显示设置并继续。这个选项的可能类别参数包括以下内容:

all 显示设置的所有类别。这是默认值。

locale 显示与locale相关的设置。

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

vm 显示JVM设置。

system Linux: 显示主机系统或容器配置并继续。

-Xss size 设置线程堆栈大小(单位为字节)。k或K表示KB, m或M表示MB, g或G表示GB。默认值取决于平台:

Linux/x64(64位):1024kb
macOS(64位):1024kb
Windows:默认值取决于虚拟内存
下面的示例以不同的单位将线程堆栈大小设置为1024kb:

-Xss1m
-Xss1024k
-Xss1048576

这个选项类似于-XX:ThreadStackSize。

-Xverify 设置字节码校验器的模式。

–add-reads module=target-module(，target-module)* 更新模块以读取目标模块，而不管模块声明是什么。目标模块可以全部未命名以读取所有未命名模块。

–add-exports module/package=target-module(，target-module)目标模块可以全部未命名，以导出到所有未命名模块。

–add-open module/package=target-module(，target-module)*更新模块以打开包到目标模块，不管模块声明。

–illegal-access=parameter 当在运行时出现时，–illegal-access= 接受一个关键字参数来指定操作模式:

permit:这种模式打开运行时映像中每个模块中的每个包，在所有未命名的模块(比如类路径上的代码)中编码，如果这个包存在于JDK 8中。这既支持静态访问(例如，通过编译的字节码)，也支持通过平台的各种反射api进行深度反射访问。对任何此类包的第 - 一个反射访问操作将导致发出警告。但是，在第一次出现后不会发出警告。此警告描述如何启用进一步的警告。此模式是当前JDK的默认模式，但将在未来的版本中更改。
warn:此模式与permit相同，只是对每个非法的反射访问操作都会发出警告消息。
debug:此模式与warn模式相同，只是对每个非法的反射访问操作都发出警告消息和堆栈跟踪。
deny:该模式禁用所有非法访问操作，其他命令行选项(如–add-open)启用的操作除外。在以后的版本中，该模式将成为默认模式。

默认模式–illegal-access=permit 旨在让您知道类路径上至少一次反射访问任何jdk内部api的代码。要了解所有此类访问，可以使用警告或调试模式。对于类路径上需要非法访问的每个库或框架，您有两个选项:

如果组件的维护者已经发布了一个不再使用jdk内部api的固定版本，那么您可以考虑升级到该版本。
如果组件仍然需要修复，那么您可以联系它的维护人员，让他们使用适当的导出api替换jdk内部api。
如果必须继续使用需要非法访问的组件，那么可以使用一个或多个–add- opens选项只打开需要访问的那些内部包，从而消除警告消息。

要验证您的应用程序是否已经为JDK的未来版本做好了准备，请使用–illegal-access=deny和任何必要的–add- opens选项运行它。任何剩余的非法访问错误很可能是由于从编译代码到jdk内部api的静态引用。您可以通过运行带有–jdk-internals选项的jdeps工具来识别它们。出于性能原因，当前JDK不会对非法静态访问操作发出警告。

–limit-modules module[,module…] 指定可观察模块的范围。

–patch-module module=file(;file)* 使用JAR文件或目录中的类和资源覆盖或扩充模块。

–disable-@files 可以在命令行中的任何地方使用，包括在参数文件中，以防止@filename进一步展开。该选项在选项之后停止展开@-argfiles。

–source version 设置源文件模式下的版本。

MacOS的额外选项

以下额外选项是特定于macos的。

-XstartOnFirstThread 在第一个(AppKit)线程上运行main()方法。

-Xdock:name=application_name 覆盖dock中显示的默认应用名称。

-Xdock:icon=path_to_icon_file 覆盖dock中的默认图标。

高级运行时选项

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

-XX:ActiveProcessorCount=x 覆盖虚拟机将使用的cpu数量，以计算线程池的大小，它将使用各种操作，如垃圾收集和ForkJoinPool。

VM通常决定操作系统中可用处理器的数量。当在docker容器中运行多个Java进程时，此标志对于分区CPU资源非常有用。即使UseContainerSupport未启用，此标志也将被尊重。有关启用和禁用容器支持的描述，请参见-XX:-UseContainerSupport。

–XX:AllocateHeapAt=path 获取文件系统的路径，并使用内存映射在内存设备上分配对象堆。使用此选项，HotSpot虚拟机可以将Java对象堆分配到用户指定的替代内存设备上，例如NV-DIMM。

与DRAM具有相同语义的替代内存设备(包括原子操作的语义)可以用于对象堆，而无需更改现有的应用程序代码。所有其他内存结构(如代码堆、元空间和线程堆栈)继续驻留在DRAM中。

一些操作系统通过文件系统公开非dram内存。这些文件系统中的内存映射文件绕过页面缓存，并提供虚拟内存到设备上物理内存的直接映射。现有的堆相关标志(如-Xmx和-Xms)和垃圾收集相关标志继续像以前一样工作。

-XX:-CompactStrings 禁用CompactStrings特性。默认情况下，该选项是启用的。当启用此选项时，只包含单字节字符的Java字符串将在内部表示，并使用ISO-8859-1 / Latin-1编码将其存储为每个字符的单字节字符串。这将使只包含单字节字符的字符串所需的空间减少50%。对于至少包含一个多字节字符的Java字符串:这些字符使用UTF-16编码表示并存储为每个字符2个字节。禁用紧凑字符串特性将强制使用UTF-16编码作为所有Java字符串的内部表示。

禁用紧凑字符串可能有益的情况包括:

当应用程序压倒性地将分配多字节字符串时
在意外的情况下，当从Java SE 8迁移到Java SE 9或更高版本时观察到性能回归时，分析表明Compact Strings引入了回归

在这两种情况下，禁用紧凑字符串都是有意义的。

-XX:CompilerDirectivesFile=file当程序启动时，将文件中的指令添加到指令堆栈中。请参阅编译器指令和命令行。

-XX:CompilerDirectivesPrint 当程序启动或添加新指令时打印指令堆栈。

-XX:ConcGCThreads=n 设置并行标记线程的数量。将n设置为并行垃圾收集线程数(ParallelGCThreads)的大约1/4。

-XX:+DisableAttachMechanism 禁用让工具附加到JVM的机制。默认情况下，该选项是禁用的，这意味着附加机制是启用的，您可以使用诊断和故障排除工具，如jcmd、jstack、jmap和jinfo。

-XX:ErrorFile=filename 当发生不可恢复的错误时，将错误数据写入的路径和文件名。默认情况下，该文件在当前工作目录中创建，命名为hs_err_pidd .log，其中pid是导致错误的进程的标识符。

下面的示例演示如何设置默认日志文件(注意，进程的标识符被指定为%p):

-XX:ErrorFile=./hs_err_pid%p.log

Linux和macOS操作系统:以“/var/log/java/java_error.log”为例进行说明
XX: ErrorFile = /var/log/java/java_error.log ```
Windows操作系统:将错误日志文件设置为“C:/log/java/java_error.log: ```shell
XX: ErrorFile = C: /日志/ java / java_error.log ```
如果文件不能在指定的目录中创建(由于空间不足、权限问题或其他问题)，则在操作系统的临时目录中创建文件:
Linux和macOS: 临时目录为“/tmp”。
Windows: 临时目录由TMP环境变量的值指定。如果没有定义该环境变量，则使用TEMP环境变量的值。

-XX:+ExtensiveErrorReports 允许在ErrorFile中报告更广泛的错误信息。在需要最大信息的环境中可以打开此选项 - 即使生成的日志可能相当大，并且/或包含可能被认为是敏感的信息。不同版本和不同平台的信息可能不同。默认情况下，该选项是禁用的。

-XX:+FailOverToOldVerifier 当新类型校验器失败时，自动切换到旧的校验器。默认情况下，该选项是禁用的，对于具有最新字节码版本的类，它将被忽略(即视为禁用)。您可以为使用较旧版本字节码的类启用它。

-XX:+FlightRecorder 允许在应用程序运行时使用JFR (Java FlightRecorder)。

-XX:FlightRecorderOptions=parameter=value 设置控制JFR行为的参数。

下面的列表包含了可用的JFR参数=value条目:

allow_threadbuffers_to_disk={true|false} 如果缓冲区线程被阻塞，是否会将线程缓冲区直接写入磁盘。缺省情况下，该参数为禁用状态。

globalbuffersize=size 用于数据保留的主内存总量。默认值基于为memorysize指定的值。更改memorysize参数以更改全局缓冲区的大小。

maxchunksize=size 记录中数据块的最大大小(单位为字节)。附加m或M以指定大小，单位为兆字节(MB)，附加g或G以指定大小，单位为千兆字节(GB)。默认情况下，最大数据块大小为12mb，最小数据块大小为1mb。

memorysize=size 决定应该使用多少缓冲内存，并根据指定的大小设置globalbuffersize和numglobalbuffers参数。附加m或M以指定大小，单位为兆字节(MB)，附加g或G以指定大小，单位为千兆字节(GB)。默认情况下，内存大小为10mb。

numglobalbuffers 使用的全局缓冲区数量。默认值是基于指定的内存大小。更改memorysize参数以更改全局缓冲区的数量。

old-object-queue-size=number-of-objects 要跟踪的最大旧对象数量。缺省情况下，节点数为256个。

repository=path 磁盘临时存储的存储库(目录)。默认情况下，使用系统的临时目录。

retransform={true|false} 指定是否应该使用JVMTI重新转换事件类。如果为false，则在加载事件类时添加检测。缺省情况下，开启该参数。

samplethreads={true|false} 是否启用线程采样。只有当采样事件与此参数一起启用时，才会发生线程采样。缺省情况下，开启该参数。

stackdepth=depth 堆栈跟踪的堆栈深度。默认情况下，深度设置为64次方法调用。最大值是2048个。大于64的值会产生巨大的开销并降低性能。

threadbuffersize=size 每个线程的本地缓冲区大小(单位为字节)。缺省情况下，本地缓冲区大小设置为8kb。重写此参数可能会降低性能，因此不建议重写。

可以为多个参数指定值，参数之间用逗号分隔。

-XX:InitiatingHeapOccupancyPercent=n 设置触发标记周期的Java堆占用阈值。默认的占用率是整个Java堆的45%。

-XX:LargePageSizeInBytes=size Linux和macOS:设置用于Java堆的大页面的最大大小(以字节为单位)。size参数必须是2的幂(2、4、8、16，等等)。加上字母k或k表示千字节，m或M表示兆字节，g或G表示千兆字节。默认情况下，大小被设置为0，这意味着JVM会自动选择大页面的大小。

设置大页面大小为4mb的示例如下:

-XX:LargePageSizeInBytes=4m

-XX:MaxDirectMemorySize=size 设置 java.nio包直接缓冲区分配的最大总大小(字节)。加上字母k或K表示千字节，m或M表示兆字节，g或G表示千兆字节。默认情况下，大小被设置为0，这意味着JVM自动选择NIO直接缓冲区分配的大小。

下面的示例演示如何以不同的单位将NIO大小设置为1024kb:

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

-XX:-MaxFDLimit 禁用将打开的文件描述符数量的软限制设置为硬限制的尝试。默认情况下，该选项在所有平台上都是启用的，但在Windows上被忽略。唯一需要禁用此功能的时候是在Mac OS上，它的使用限制了最大10240，低于实际的系统最大值。

-XX:MaxGCPauseMillis=ms 设置目标的最大暂停时间。缺省值是200毫秒。指定的值不适合您的堆大小。

-XX: nativemorytracking =mode 指定跟踪JVM本机内存使用情况的模式。此选项的可能模式参数包括:

off 指示不要跟踪JVM本机内存使用情况。如果没有指定-XX: nativemorytracking选项，这是默认行为。

summary 只跟踪JVM子系统(如Java堆、类、代码和线程)的内存使用情况。

detail 除了跟踪JVM子系统的内存使用情况，还可以跟踪单个CallSite、单个虚拟内存区域及其提交区域的内存使用情况。

-XX:ObjectAlignmentInBytes=alignment 设置Java对象的内存对齐方式(以字节为单位)。缺省值为8字节。指定的值应该是2的幂，并且必须在8和256(包括)的范围内。这个选项使得使用具有大Java堆大小的压缩指针成为可能。

堆大小限制(以字节为单位)计算如下:

4GB * ObjectAlignmentInBytes

-XX:OnError=string 设置一个自定义命令或一系列以分号分隔的命令，当不可恢复的错误发生时运行。如果字符串包含空格，则必须用引号括起来。

Linux和macOS:下面的示例展示了如何使用-XX:OnError选项来运行gcore命令来创建核心映像，并且在出现不可恢复的错误(%p指定当前进程)时启动调试器来附加到进程上:

-XX:OnError="gcore %p;dbx - %p"

Windows:以下示例显示如何使用-XX:OnError选项来运行userdump.exe工具，在出现不可恢复的错误(%p指定当前进程)时获取崩溃转储。本例假设userdump.exe实用程序的路径是在path环境变量中指定的
XX:OnError=“userdump.exe %p” ```
-XX:OnOutOfMemoryError=string 设置一个自定义命令或一系列分号分隔的命令，当OutOfMemoryError第一次抛出时运行。如果字符串包含空格，则必须用引号括起来。有关命令字符串的示例，请参见-XX:OnError选项的描述。

-XX:ParallelGCThreads=n 设置STW工作线程的值。将n的值设置为逻辑处理器的数量。n的值等于8以内的逻辑处理器的数量。如果有超过8个逻辑处理器，那么这个选项将n的值设置为大约5/8个逻辑处理器。除了更大的SPARC系统外，大多数情况下这都是可行的，在SPARC系统中，n的值大约是逻辑处理器的5/16。

-XX:+PerfDataSaveToFile 如果启用，则在Java应用退出时保存jstat二进制数据。这个二进制数据保存在一个名为hsperfdata_pid的文件中，其中pid是您运行的Java应用程序的进程标识符。使用jstat命令显示文件中包含的性能数据，如下所示:

jstat -class file:///path/hsperfdata_pid

jstat -gc file:///path/hsperfdata_pid

-XX:+PrintCommandLineFlags 允许打印出现在命令行上的符合人体工程学的选择的JVM标志。了解JVM设置的人体工程学值是很有用的，比如堆空间大小和所选的垃圾收集器。默认情况下，该选项是禁用的，不会打印标志。

-XX:+PreserveFramePointer 在使用RBP寄存器作为通用寄存器(-XX:-PreserveFramePointer)和使用RBP寄存器保存当前正在执行的方法的帧指针(-XX:+PreserveFramePointer)之间进行选择。如果帧指针是可用的，那么外部分析工具(例如，Linux perf)可以构造更精确的堆栈跟踪。

-XX:+PrintNMTStatistics 启用本机内存跟踪时，在JVM退出时打印收集的本机内存跟踪数据(参见-XX:本机内存跟踪)。默认情况下，该选项是禁用的，本机内存跟踪数据不会打印。

-XX:+RelaxAccessControlCheck 减少校验者中的访问控制检查数量。默认情况下，该选项是禁用的，对于具有最新字节码版本的类，它将被忽略(即视为禁用)。您可以为使用较旧版本字节码的类启用它。

-XX:SharedArchiveFile=path 类数据共享(CDS)归档文件的路径和名称

-XX:SharedArchiveConfigFile=shared_config_file 添加到归档文件的额外共享数据。

-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记录。这个选项相当于JFR。启动诊断命令，在运行时启动记录。在启动JFR录音时，可以设置以下parameter=value项:

delay=time从Java应用程序启动到开始记录之间的延迟时间。附加s以指定以秒为单位的时间，m代表分钟，h代表小时，d代表天。例如，指定10m表示10分钟。默认情况下，没有延迟，这个参数设置为0。

disk={true|false} 记录时是否将数据写入磁盘。缺省情况下，开启该参数。

dumponexit={true|false} JVM关闭时是否转储运行记录。如果启用且未输入文件名，则记录将写入进程启动目录中的文件。文件名称为系统生成的名称，包含进程ID、记录ID和当前时间戳，类似于hotspot-pid-47496-id-1-2018_01_25_19_10_41.jfr。缺省情况下，该参数为禁用状态。

duration=time 记录持续时间。附加s以指定以秒为单位的时间，m代表分钟，h代表小时，d代表天。例如，指定5h意味着5个小时。默认情况下，持续时间不受限制，该参数设置为0。

filename=path 停止记录时写入的文件路径和文件名。例如:

recording.jfr
/home/user/recordings/recording.jfr
c:\recordings\recording.jfr
name=identifier 记录的名称和标识符。

maxage=time 指定要记录的磁盘数据的最大保存时间。当磁盘参数设置为“true”时，该参数有效。附加s以指定以秒为单位的时间，m代表分钟，h代表小时，d代表天。例如，指定30s意味着30秒。默认情况下，不限制最大年龄，该参数设置为0。

maxsize=size 用于记录的磁盘数据的最大大小(以字节为单位)。当磁盘参数设置为“true”时，该参数有效。该值不能小于通过-XX:FlightRecorderOptions设置的maxchunksize参数的值。附加m或M以指定大小(以兆字节为单位)，附加g或G以指定大小(以千兆字节为单位)。默认情况下，不限制磁盘数据的最大大小，该参数设置为0。

path-to- GC -root ={true|false}是否在记录结束时收集GC根路径。缺省情况下，该参数为禁用状态。

GC根路径对于查找内存泄漏很有用，但是收集它很耗时。只有当您为怀疑存在内存泄漏的应用程序启动记录时，才启用此选项。如果settings参数设置为profile，则收集的信息中包含从何处分配潜在泄漏对象的堆栈跟踪。

settings=path 事件设置文件(JFC类型)的路径和名称。缺省情况下，为default.jfc文件，位于JRE_HOME/lib/jfr。这个默认设置文件以低开销收集一组预定义的信息，因此它对性能的影响很小，可以用于连续运行的记录。

还提供了第二个设置文件:profile.Jfc提供了比默认配置更多的数据，但是会有更多的开销和性能影响。当需要更多信息时，请在短时间内使用此配置。

可以为多个参数指定值，参数之间用逗号分隔。

-XX:ThreadStackSize=size 设置Java线程堆栈大小(单位为千字节)。使用伸缩后缀，例如k，会导致千字节值的伸缩，因此-XX:ThreadStackSize=1k将Java线程堆栈大小设置为1024*1024字节或1兆字节。默认值取决于平台:

Linux: 1024 KB
macOS: 1024 KB
Windows:默认值取决于虚拟内存。
下面的例子展示了如何以不同的单位将线程堆栈大小设置为1兆字节:

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

这个选项类似于-Xss。

-XX:-UseBiasedLocking 禁用偏差锁定。一些具有大量无争用同步的应用程序在启用此标志后可能获得显著的速度提升，但具有某些锁定模式的应用程序可能会看到速度变慢。

默认情况下，该选项是启用的。

-XX:-UseCompressedOops 禁止使用压缩指针。默认情况下，这个选项是启用的，并且当Java堆大小小于32gb时使用压缩指针。当启用此选项时，对象引用将表示为32位偏移量而不是64位指针，这通常会在Java堆大小小于32 GB的情况下运行应用程序时提高性能。此选项仅适用于64位jvm。

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

-XX:-UseContainerSupport 虚拟机现在提供了自动容器检测支持，这允许虚拟机确定运行在docker容器中的Java进程可用的内存数量和处理器数量。它使用这个信息来分配系统资源。这种支持仅在Linux x64平台上可用。如果受支持，此标志的默认值为true，默认情况下启用容器支持。可以通过-XX:-UseContainerSupport禁用。

统一日志可以帮助诊断与此支持相关的问题。

使用-Xlog:os+container=trace来最大限度地记录容器信息。有关使用统一日志的描述，请参见使用JVM统一日志框架启用日志。

-XX:+ usegclogroation 处理大的日志文件。该选项必须与-Xloggc:filename一起使用。

-XX:NumberOfGClogFiles=number_of_files 处理大的日志文件。number_of_files必须大于等于1。默认值是1。

-XX:GCLogFileSize=number 处理大的日志文件。数字可以是数字m或数字k的形式。默认设置为512K。

-XX:+UseHugeTLBFS 仅Linux:该选项等同于指定-XX:+UseLargePages。默认情况下，该选项是禁用的。这个选项在预留内存时预先分配所有大页面;因此，JVM不能动态地增加或缩小大页面的内存区域。请参阅-XX:UseTransparentHugePages，如果你想要这个行为。

-XX:+UseLargePages 启用大页内存。默认情况下，该选项是禁用的，并且不会使用大页面内存。

-XX:+UseMembar 允许在线程状态转换时发出成员。这个选项默认在所有平台上禁用，除了ARM服务器，在ARM服务器上启用。(建议您不要在ARM服务器上禁用此选项。)

-XX:+UsePerfData启用perfdata特性。默认情况下启用此选项以允许JVM监视和性能测试。禁用它将抑制hsperfdata_userid目录的创建。如果需要禁用perfdata特性，指定-XX:-UsePerfData。

-XX:+UseTransparentHugePages 仅Linux:启用可以动态增长或收缩的大页面。默认情况下，该选项是禁用的。当操作系统移动其他页面来创建大页面时，您可能会遇到透明大页面的性能问题;这个选项可以用于实验。

-XX:+AllowUserSignalHandlers 允许应用程序安装信号处理器。默认情况下，这个选项是禁用的，应用程序不允许安装信号处理程序。

-XX:VMOptionsFile=filename 允许用户在文件中指定虚拟机选项，例如:

java -XX:VMOptionsFile=/var/my_vm_options HelloWorld

高级JIT编译器选项

这些java选项控制java HotSpot VM执行的动态JIT编译。

-XX:AllocateInstancePrefetchLines=lines设置在实例分配指针之前预取的行数。缺省情况下，预取行数为1:

-XX:AllocateInstancePrefetchLines=1

设置在实例分配指针之前预取的行数。缺省情况下，预取行数为1:

-XX:AllocateInstancePrefetchLines=1