java 启动参数大全

客官°小女子只卖身不卖艺 2022-08-20 10:17 34阅读 0赞

java启动参数共分为三类：

*  **标准参数**（-），所有的JVM实现都必须实现这些参数的功能，而且向后兼容；
 *  **非标准参数**（-X），默认jvm实现这些参数的功能，但是并不保证所有jvm实现都满足，且不保证向后兼容；
 *  **非Stable参数**（-XX），此类参数各个jvm实现会有所不同，将来可能会随时取消，需要慎重使用；

**目录**

一．标准参数

二．非标准参数

三．非Stable参数

--------------------

## **一．标准参数** ##

**-client **  设置jvm使用client模式，特点是启动速度比较快，但运行时性能和内存管理效率不高，通常用于客户端应用程序或者PC应用开发和调试。

**-server**  设置jvm使server模式，特点是启动速度比较慢，但运行时性能和内存管理效率很高，适用于生产环境。在具有64位能力的jdk环境下将默认启用该模式，而忽略-client参数。

**-agentlib:libname\[=options\]**   用于装载本地lib包；  其中 libname为本地代理库文件名，默认搜索路径为环境变量PATH中的路径，options为传给本地库启动时的参数，多个参数之间用逗号分隔。在 Windows平台上jvm搜索本地库名为libname.dll的文件，在linux上jvm搜索本地库名为libname.so的文件，搜索路径环境变量在不同系统上有所不同，比如Solaries上就默认搜索LD\_LIBRARY\_PATH。  比如：-agentlib:hprof  用来获取jvm的运行情况，包括CPU、内存、线程等的运行数据，并可输出到指定文件中；windows中搜索路径为JRE\_HOME/bin/hprof.dll。

**-agentpath:pathname\[=options\]**   按全路径装载本地库，不再搜索PATH中的路径；其他功能和agentlib相同；更多的信息待续，在后续的JVMTI部分会详述。

**-classpath classpath  -cp classpath**   告知jvm搜索目录名、jar文档名、zip文档名，之间用分号;分隔；使用-classpath后jvm将不再使用CLASSPATH中的类搜索路径，如果-classpath和CLASSPATH都没有设置，则jvm使用当前路径(.)作为类搜索路径。  jvm搜索类的方式和顺序为：Bootstrap，Extension，User。  Bootstrap中的路径是jvm自带的jar或zip文件，jvm首先搜索这些包文件，用System.getProperty("sun.boot.class.path")可得到搜索路径。  Extension是位于JRE\_HOME/lib/ext目录下的jar文件，jvm在搜索完Bootstrap后就搜索该目录下的jar文件，用System.getProperty("java.ext.dirs")可得到搜索路径。  User搜索顺序为当前路径.、CLASSPATH、-classpath，jvm最后搜索这些目录，用System.getProperty("java.class.path")可得到搜索路径。

**-Dproperty=value**  设置系统属性名/值对，运行在此jvm之上的应用程序可用System.getProperty("property")得到value的值。  如果value中有空格，则需要用双引号将该值括起来，如-Dname="space string"。  该参数通常用于设置系统级全局变量值，如配置文件路径，以便该属性在程序中任何地方都可访问。

**-enableassertions\[:<package name>"..." | :<classname> \]  -ea\[:<package name>"..." | :<class name> \]**   上述参数就用来设置jvm是否启动断言机制（从JDK 1.4开始支持），缺省时jvm关闭断言机制。   用-ea 可打开断言机制，不加<packagename>和classname时运行所有包和类中的断言，如果希望只运行某些包或类中的断言，可将包名或类名加到-ea之后。例如要启动包com.wombat.fruitbat中的断言，可用命令java -ea:com.wombat.fruitbat...<Main Class>。

**-disableassertions\[:<package name>"..." | :<class ; \]  -da\[:<package name>"..." | :<class name> \]**  用来设置jvm关闭断言处理，packagename和classname的使用方法和-ea相同，jvm默认就是关闭状态。  该参数一般用于相同package内某些class不需要断言的场景，比如com.wombat.fruitbat需要断言，但是com.wombat.fruitbat.Brickbat该类不需要，则可以如下运行：  java -ea:com.wombat.fruitbat...-da:com.wombat.fruitbat.Brickbat <MainClass>。 **-enablesystemassertions  -esa**   激活系统类的断言。 **-disablesystemassertions  -dsa**   关闭系统类的断言。

**-jar**   指定以jar包的形式执行一个应用程序。  要这样执行一个应用程序，必须让jar包的manifest文件中声明初始加载的Main-class，当然那Main-class必须有public static void main(String\[\] args)方法。

**-javaagent:jarpath\[=options\]**   指定jvm启动时装入java语言设备代理。  Jarpath 文件中的mainfest文件必须有Agent-Class属性。代理类也必须实现公共的静态public static void premain(String agentArgs, Instrumentation inst)方法（和main方法类似）。当jvm初始化时，将按代理类的说明顺序调用premain方法；具体参见 java.lang.instrument软件包的描述。

**-verbose  -verbose:class**   输出jvm载入类的相关信息，当jvm报告说找不到类或者类冲突时可此进行诊断。 **-verbose:gc**   输出每次GC的相关情况。 **-verbose:jni**   输出native方法调用的相关情况，一般用于诊断jni调用错误信息。 **-version**   输出java的版本信息，比如jdk版本、vendor、model。 **-version:release**   指定class或者jar运行时需要的jdk版本信息；若指定版本未找到，则以能找到的系统默认jdk版本执行；一般情况下，对于jar文件，可以在manifest文件中指定需要的版本信息，而不是在命令行。  release中可以指定单个版本，也可以指定一个列表，中间用空格隔开，且支持复杂组合，比如：  -version:"1.5.0\_04 1.5\*&1.5.1\_02+"  指定class或者jar需要jdk版本为1.5.0\_04或者是1.5系列中比1.5.1\_02更高的所有版本。

**-showversion**   输出java版本信息（与-version相同）之后，继续输出java的标准参数列表及其描述。 **-?  -help**   输出java标准参数列表及其描述。

##  **二．非标准参数** ##

**-X**  输出非标准的参数列表及其描述。

以上的这些参数我们经常会在很多情况下用到多个的组合，比如我们在用JProfiler进行跟踪监控时，需要在被监控java启动参数中加上如下配置：-agentlib:jprofilerti=port=8849 -Xbootclasspath/a:/usr/local/jprofiler5/bin/agent.jar其中就用到两个-agentlib和-X参数，bootclasspath参数的详细信息将会在非标准参数中详细说明。

**-Xint**  设置jvm以解释模式运行，所有的字节码将被直接执行，而不会编译成本地码。   **-Xbatch**  关闭后台代码编译，强制在前台编译，编译完成之后才能进行代码执行；  默认情况下，jvm在后台进行编译，若没有编译完成，则前台运行代码时以解释模式运行。   **-Xbootclasspath:bootclasspath**  让jvm从指定路径（可以是分号分隔的目录、jar、或者zip）中加载bootclass，用来替换jdk的rt.jar；若非必要，一般不会用到； **-Xbootclasspath/a:path**  将指定路径的所有文件追加到默认bootstrap路径中； **-Xbootclasspath/p:path**  让jvm优先于bootstrap默认路径加载指定路径的所有文件； **  -Xcheck:jni**  对JNI函数进行附加check；此时jvm将校验传递给JNI函数参数的合法性，在本地代码中遇到非法数据时，jmv将报一个致命错误而终止；使用该参数后将造成性能下降，请慎用。   **-Xfuture**  让jvm对类文件执行严格的格式检查（默认jvm不进行严格格式检查），以符合类文件格式规范，推荐开发人员使用该参数。   **-Xnoclassgc**  关闭针对class的gc功能；因为其阻止内存回收，所以可能会导致OutOfMemoryError错误，慎用；   **-Xincgc**  开启增量gc（默认为关闭）；这有助于减少长时间GC时应用程序出现的停顿；但由于可能和应用程序并发执行，所以会降低CPU对应用的处理能力。   **-Xloggc:file**  与-verbose:gc功能类似，只是将每次GC事件的相关情况记录到一个文件中，文件的位置最好在本地，以避免网络的潜在问题。  若与verbose命令同时出现在命令行中，则以-Xloggc为准。   **-Xmsn**  指定jvm堆的初始大小，默认为物理内存的1/64，最小为1M；可以指定单位，比如k、m，若不指定，则默认为字节。   **-Xmxn**  指定jvm堆的最大值，默认为物理内存的1/4或者1G，最小为2M；单位与-Xms一致。   **-Xprof**  跟踪正运行的程序，并将跟踪数据在标准输出输出；适合于开发环境调试。   **-Xrs**  减少jvm对操作系统信号（signals）的使用，该参数从1.3.1开始有效；  从jdk1.3.0开始，jvm允许程序在关闭之前还可以执行一些代码（比如关闭数据库的连接池），即使jvm被突然终止；  jvm 关闭工具通过监控控制台的相关事件而满足以上的功能；更确切的说，通知在关闭工具执行之前，先注册控制台的控制handler，然后对 CTRL\_C\_EVENT, CTRL\_CLOSE\_EVENT,CTRL\_LOGOFF\_EVENT, and CTRL\_SHUTDOWN\_EVENT这几类事件直接返回true。  但如果jvm以服务的形式在后台运行（比如servlet引擎），他能接收CTRL\_LOGOFF\_EVENT事件，但此时并不需要初始化关闭程序；为了避免类似冲突的再次出现，从jdk1.3.1开始提供-Xrs参数；当此参数被设置之后，jvm将不接收控制台的控制handler，也就是说他不监控和处理CTRL\_C\_EVENT, CTRL\_CLOSE\_EVENT, CTRL\_LOGOFF\_EVENT, orCTRL\_SHUTDOWN\_EVENT事件。   **-Xssn**  设置单个线程栈的大小，一般默认为512k。

上面这些参数中，比如-Xmsn、-Xmxn……都是我们性能优化中很重要的参数； -Xprof、-Xloggc:file等都是在没有专业跟踪工具情况下排错的好手； 在上一小节中提到的关于JProfiler的配置中就使用到了-Xbootclasspath/a:path

##  **三．非Stable参数** ##

前面我们提到用-XX作为前缀的参数列表在jvm中可能是不健壮的，SUN也不推荐使用，后续可能会在没有通知的情况下就直接取消了；但是由于这些参数中的确有很多是对我们很有用的，比如我们经常会见到的-XX:PermSize、-XX:MaxPermSize等等；

下面我们将就Java HotSpot VM中**-XX:**的可配置参数列表进行描述； 这些参数可以被松散的聚合成三类： **行为参数**（Behavioral Options）：用于改变jvm的一些基础行为； **性能调优**（Performance Tuning）：用于jvm的性能调优； **调试参数**（Debugging Options）：一般用于打开跟踪、打印、输出等jvm参数，用于显示jvm更加详细的信息；

由于sun官方文档中对各参数的描述也都非常少（大多只有一句话），而且大多涉及OS层面的东西，很难描述清楚，所以以下是挑选了一些我们开发中可能会用得比较多的配置项，若需要查看所有参数列表，可以点击[HotSpot VM Specific Options][].查看原文；

首先来介绍**行为参数**：

<table> 
 <tbody> 
 <tr> 
 <td style="border-color:#a5a5a5;width:169.85pt;"> 参数及其默认值 </td> 
 <td style="border-color:#a5a5a5;width:244.95pt;"> 描述 </td> 
 </tr> 
 <tr> 
 <td style="border-color:#c9c9c9;width:169.85pt;"> -XX:-DisableExplicitGC </td> 
 <td style="width:244.95pt;"> 禁止调用System.gc()；但jvm的gc仍然有效 </td> 
 </tr> 
 <tr> 
 <td style="border-color:#c9c9c9;width:169.85pt;"> -XX:+MaxFDLimit </td> 
 <td style="width:244.95pt;"> 最大化文件描述符的数量限制 </td> 
 </tr> 
 <tr> 
 <td style="border-color:#c9c9c9;width:169.85pt;"> -XX:+ScavengeBeforeFullGC </td> 
 <td style="width:244.95pt;"> 新生代GC优先于Full GC执行 </td> 
 </tr> 
 <tr> 
 <td style="border-color:#c9c9c9;width:169.85pt;"> -XX:+UseGCOverheadLimit </td> 
 <td style="width:244.95pt;"> 在抛出OOM之前限制jvm耗费在GC上的时间比例 </td> 
 </tr> 
 <tr> 
 <td style="border-color:#c9c9c9;width:169.85pt;"> -XX:-UseConcMarkSweepGC </td> 
 <td style="width:244.95pt;"> 对老生代采用并发标记交换算法进行GC </td> 
 </tr> 
 <tr> 
 <td style="border-color:#c9c9c9;width:169.85pt;"> -XX:-UseParallelGC </td> 
 <td style="width:244.95pt;"> 启用并行GC </td> 
 </tr> 
 <tr> 
 <td style="border-color:#c9c9c9;width:169.85pt;"> -XX:-UseParallelOldGC </td> 
 <td style="width:244.95pt;"> 对Full GC启用并行，当-XX:-UseParallelGC启用时该项自动启用 </td> 
 </tr> 
 <tr> 
 <td style="border-color:#c9c9c9;width:169.85pt;"> -XX:-UseSerialGC </td> 
 <td style="width:244.95pt;"> 启用串行GC </td> 
 </tr> 
 <tr> 
 <td style="border-color:#c9c9c9;width:169.85pt;"> -XX:+UseThreadPriorities </td> 
 <td style="width:244.95pt;"> 启用本地线程优先级 </td> 
 </tr> 
 </tbody> 
</table>

上面表格中黑体的三个参数代表着jvm中GC执行的三种方式，即串行、并行、并发；

*   串行（**SerialGC**）是jvm的默认GC方式，一般适用于小型应用和单处理器，算法比较简单，GC效率也较高，但可能会给应用带来停顿；
 *   并行（**ParallelGC**）是指GC运行时，对应用程序运行没有影响，GC和app两者的线程在并发执行，这样可以最大限度不影响app的运行；
 *   并发（**ConcMarkSweepGC**）是指多个线程并发执行GC，一般适用于多处理器系统中，可以提高GC的效率，但算法复杂，系统消耗较大；

**性能调优**参数列表：日常性能调优中基本上都会用到以上黑体的这几个属性

<table> 
 <tbody> 
 <tr> 
 <td style="border-color:#a5a5a5;width:180.15pt;"> 参数及其默认值 </td> 
 <td style="border-color:#a5a5a5;width:234.65pt;"> 描述 </td> 
 </tr> 
 <tr> 
 <td style="border-color:#c9c9c9;width:180.15pt;"> -XX:LargePageSizeInBytes=4m </td> 
 <td style="width:234.65pt;"> 设置用于Java堆的大页面尺寸 </td> 
 </tr> 
 <tr> 
 <td style="border-color:#c9c9c9;width:180.15pt;"> -XX:MaxHeapFreeRatio=70 </td> 
 <td style="width:234.65pt;"> GC后java堆中空闲量占的最大比例 </td> 
 </tr> 
 <tr> 
 <td style="border-color:#c9c9c9;width:180.15pt;"> -XX:MaxNewSize=size </td> 
 <td style="width:234.65pt;"> 新生成对象能占用内存的最大值 </td> 
 </tr> 
 <tr> 
 <td style="border-color:#c9c9c9;width:180.15pt;"> -XX:MaxPermSize=64m </td> 
 <td style="width:234.65pt;"> 老生代对象能占用内存的最大值 </td> 
 </tr> 
 <tr> 
 <td style="border-color:#c9c9c9;width:180.15pt;"> -XX:MinHeapFreeRatio=40 </td> 
 <td style="width:234.65pt;"> GC后java堆中空闲量占的最小比例 </td> 
 </tr> 
 <tr> 
 <td style="border-color:#c9c9c9;width:180.15pt;"> -XX:NewRatio=2 </td> 
 <td style="width:234.65pt;"> 新生代内存容量与老生代内存容量的比例 </td> 
 </tr> 
 <tr> 
 <td style="border-color:#c9c9c9;width:180.15pt;"> -XX:NewSize=2.125m </td> 
 <td style="width:234.65pt;"> 新生代对象生成时占用内存的默认值 </td> 
 </tr> 
 <tr> 
 <td style="border-color:#c9c9c9;width:180.15pt;"> -XX:ReservedCodeCacheSize=32m </td> 
 <td style="width:234.65pt;"> 保留代码占用的内存容量 </td> 
 </tr> 
 <tr> 
 <td style="border-color:#c9c9c9;width:180.15pt;"> -XX:ThreadStackSize=512 </td> 
 <td style="width:234.65pt;"> 设置线程栈大小，若为0则使用系统默认值 </td> 
 </tr> 
 <tr> 
 <td style="border-color:#c9c9c9;width:180.15pt;"> -XX:+UseLargePages </td> 
 <td style="width:234.65pt;"> 使用大页面内存 </td> 
 </tr> 
 </tbody> 
</table>

**调试参数**列表：

<table> 
 <tbody> 
 <tr> 
 <td style="border-color:#a5a5a5;width:232.8pt;"> 参数及其默认值 </td> 
 <td style="border-color:#a5a5a5;width:182pt;"> 描述 </td> 
 </tr> 
 <tr> 
 <td style="border-color:#c9c9c9;width:232.8pt;"> -XX:-CITime </td> 
 <td style="width:182pt;"> 打印消耗在JIT编译的时间 </td> 
 </tr> 
 <tr> 
 <td style="border-color:#c9c9c9;width:232.8pt;"> -XX:ErrorFile=./hs_err_pid&lt;pid&gt;.log </td> 
 <td style="width:182pt;"> 保存错误日志或者数据到文件中 </td> 
 </tr> 
 <tr> 
 <td style="border-color:#c9c9c9;width:232.8pt;"> -XX:-ExtendedDTraceProbes </td> 
 <td style="width:182pt;"> 开启solaris特有的dtrace探针 </td> 
 </tr> 
 <tr> 
 <td style="border-color:#c9c9c9;width:232.8pt;"> -XX:HeapDumpPath=./java_pid&lt;pid&gt;.hprof </td> 
 <td style="width:182pt;"> 指定导出堆信息时的路径或文件名 </td> 
 </tr> 
 <tr> 
 <td style="border-color:#c9c9c9;width:232.8pt;"> -XX:-HeapDumpOnOutOfMemoryError </td> 
 <td style="width:182pt;"> 当首次遭遇OOM时导出此时堆中相关信息 </td> 
 </tr> 
 <tr> 
 <td style="border-color:#c9c9c9;width:232.8pt;"> -XX:OnError="&lt;cmd args&gt;;&lt;cmd args&gt;" </td> 
 <td style="width:182pt;"> 出现致命ERROR之后运行自定义命令 </td> 
 </tr> 
 <tr> 
 <td style="border-color:#c9c9c9;width:232.8pt;"> -XX:OnOutOfMemoryError="&lt;cmd args&gt;;&lt;cmd args&gt;" </td> 
 <td style="width:182pt;"> 当首次遭遇OOM时执行自定义命令 </td> 
 </tr> 
 <tr> 
 <td style="border-color:#c9c9c9;width:232.8pt;"> -XX:-PrintClassHistogram </td> 
 <td style="width:182pt;"> 遇到Ctrl-Break后打印类实例的柱状信息，与jmap -histo功能相同 </td> 
 </tr> 
 <tr> 
 <td style="border-color:#c9c9c9;width:232.8pt;"> -XX:-PrintConcurrentLocks </td> 
 <td style="width:182pt;"> 遇到Ctrl-Break后打印并发锁的相关信息，与jstack -l功能相同 </td> 
 </tr> 
 <tr> 
 <td style="border-color:#c9c9c9;width:232.8pt;"> -XX:-PrintCommandLineFlags </td> 
 <td style="width:182pt;"> 打印在命令行中出现过的标记 </td> 
 </tr> 
 <tr> 
 <td style="border-color:#c9c9c9;width:232.8pt;"> -XX:-PrintCompilation </td> 
 <td style="width:182pt;"> 当一个方法被编译时打印相关信息 </td> 
 </tr> 
 <tr> 
 <td style="border-color:#c9c9c9;width:232.8pt;"> -XX:-PrintGC </td> 
 <td style="width:182pt;"> 每次GC时打印相关信息 </td> 
 </tr> 
 <tr> 
 <td style="border-color:#c9c9c9;width:232.8pt;"> -XX:-PrintGC Details </td> 
 <td style="width:182pt;"> 每次GC时打印详细信息 </td> 
 </tr> 
 <tr> 
 <td style="border-color:#c9c9c9;width:232.8pt;"> -XX:-PrintGCTimeStamps </td> 
 <td style="width:182pt;"> 打印每次GC的时间戳 </td> 
 </tr> 
 <tr> 
 <td style="border-color:#c9c9c9;width:232.8pt;"> -XX:-TraceClassLoading </td> 
 <td style="width:182pt;"> 跟踪类的加载信息 </td> 
 </tr> 
 <tr> 
 <td style="border-color:#c9c9c9;width:232.8pt;"> -XX:-TraceClassLoadingPreorder </td> 
 <td style="width:182pt;"> 跟踪被引用到的所有类的加载信息 </td> 
 </tr> 
 <tr> 
 <td style="border-color:#c9c9c9;width:232.8pt;"> -XX:-TraceClassResolution </td> 
 <td style="width:182pt;"> 跟踪常量池 </td> 
 </tr> 
 <tr> 
 <td style="border-color:#c9c9c9;width:232.8pt;"> -XX:-TraceClassUnloading </td> 
 <td style="width:182pt;"> 跟踪类的卸载信息 </td> 
 </tr> 
 <tr> 
 <td style="border-color:#c9c9c9;width:232.8pt;"> -XX:-TraceLoaderConstraints </td> 
 <td style="width:182pt;"> 跟踪类加载器约束的相关信息 </td> 
 </tr> 
 </tbody> 
</table>

[HotSpot VM Specific Options]: http://java.sun.com/docs/hotspot/VMOptions.html