javac命令详解

1、命令框架图

命令框架图

 

2、命令行格式： javac <options> <source files>

 

options                                            命令行选项

source files                                     一个或多个要编译的源文件（java文件）
其中, 可能的选项包括:
  -g                         生成所有调试信息
  -g:none                    不生成任何调试信息
  -g:{lines,vars,source}     只生成某些调试信息
  -nowarn                    不生成任何警告
  -verbose                   输出有关编译器正在执行的操作的消息
  -deprecation               输出使用已过时的 API 的源位置
  -classpath <路径>            指定查找用户类文件和注释处理程序的位置
  -cp <路径>                   指定查找用户类文件和注释处理程序的位置
  -sourcepath <路径>           指定查找输入源文件的位置
  -bootclasspath <路径>        覆盖引导类文件的位置
  -extdirs <目录>              覆盖所安装扩展的位置
  -endorseddirs <目录>         覆盖签名的标准路径的位置
  -proc:{none,only}          控制是否执行注释处理和/或编译。
  -processor <class1>[,<class2>,<class3>...] 要运行的注释处理程序的名称; 绕过默
认的搜索进程
  -processorpath <路径>        指定查找注释处理程序的位置
  -parameters                生成元数据以用于方法参数的反射
  -d <目录>                    指定放置生成的类文件的位置
  -s <目录>                    指定放置生成的源文件的位置
  -h <目录>                    指定放置生成的本机标头文件的位置
  -implicit:{none,class}     指定是否为隐式引用文件生成类文件
  -encoding <编码>             指定源文件使用的字符编码
  -source <发行版>              提供与指定发行版的源兼容性
  -target <发行版>              生成特定 VM 版本的类文件
  -profile <配置文件>            请确保使用的 API 在指定的配置文件中可用
  -version                   版本信息
  -help                      输出标准选项的提要
  -A关键字[=值]                  传递给注释处理程序的选项
  -X                         输出非标准选项的提要
  -J<标记>                     直接将 <标记> 传递给运行时系统
  -Werror                    出现警告时终止编译
  @<文件名>                     从文件读取选项和文件名

 

3、将source files 传给javac的两种描述方法：

    1) 使用文件路径名列表的方式，文件路径名（可以是绝对路径名，也可以是相对路径名，路径名中有空格的话需要用双引号把路径名引用起来）之间用空格分隔。

例1

javac -d classes src\com\ex\Computer.java src\com\ex\Person.java src\com\hello\Main.java

    文件列表形式可以使用通配符

例2

javac -d classes src\com\ex\*.java src\com\hello\Main.java

    2）使用@file方式

    file是一个文本文件的路径名，这个文件中存放要编译的文件的文件路径名列表,其中路径名之间使用空格或者回车分隔。

    如@src.list

    src.list:

    src\com\ex\Computer.java
   src\com\ex\Person.java
   src\com\hello\Main.java

或者

    src.list:

    src\com\ex\Computer.java src\com\ex\Person.java src\com\hello\Main.java

貌似这种情况不能使用通配符。

4、options 命令行选项

    1） -d <目录>                    指定放置生成的类文件的位置

    指定-d dir123后，javac将生成的class文件放到dir123下class对应的包名目录下；

    不指定-d选项，javac把生成的class文件放到各自java源文件的目录下。

注意： -d 选项指定的目录不会被自动添加到用户类路径中。？？？？？

 

    2）-bootclasspath，-extdirs，-classpath和-cp

JDK在编译一个java源文件时，搜索class文件的方式和顺序如下：

　　Bootstrap classes，Extension classes，User classes

Bootstrap默认的是JDK自带的jar或zip文件，它包括jre\lib下rt.jar等文件，JDK首先搜索这些文件.可以通过-bootclasspath来设置它。文件之间用分号";"进行分割。？？

Extension默认的是位于jre"lib"ext目录下的jar文件，JDK在搜索完Bootstrap后就搜索该目录下的jar文件.

可以通过-extdirs来设置。文件之间用分号";"来进行分割

User classes搜索顺序为当前目录、环境变量 CLASSPATH、-classpath。
　　-cp 和 -classpath 是同义词，参数意义是一样的。classpath参数太长了，所以提供cp作为缩写形式
　　它们用于告知JDK搜索目录名、jar文档名、zip文档名，用分号";"进行分隔。
　　例如当你自己开发了公共类并包装成一个common.jar包，在使用 common.jar中的类时，就需要用-classpath common.jar 告诉JDK从common.jar中查找该类，否则JDK就会抛出java.lang.NoClassDefFoundError异常，表明未找到类定义。
　　使用-classpath后JDK将不再使用CLASSPATH中的类搜索路径，如果-classpath和CLASSPATH都没有设置，则JDK使用当前路径(.)作为类搜索路径。
　　推荐使用-classpath来定义JDK要搜索的类路径，而不要使用环境变量 CLASSPATH的搜索路径，以减少多个项目同时使用CLASSPATH时存在的潜在冲突。例如应用1要使用a1.0.jar中的类G，应用2要使用 a2.0.jar中的类G,a2.0.jar是a1.0.jar的升级包，当a1.0.jar，a2.0.jar都在CLASSPATH中，JDK搜索到第一个包中的类G时就停止搜索，如果应用1应用2的虚拟机都从CLASSPATH中搜索，就会有一个应用得不到正确版本的类G。

示例6：javac -classpath lib\Util.zip -d classes src\com\robin\*.java
             或 javac -cp lib\Util.zip -d classes src\com\robin\*.java
 示例7：javac -classpath classes -d classes src\com\robin\*.java
            或javac -cp classes -d classes src\com\robin\*.java
 如果需要指定各个JAR文件具体的存放路径，相同路径有多个可使用通配符。

-sourcepath java源码文件路径
在编译时，JDK需要两方面的路径，一个是查找java源码文件的路径，一个是查找class（类）文件的路径。
关于class文件的路径上文已经已经介绍过，可以通过-bootclasspath，-extdirs，-classpath和-cp来设定。java源码文件的路径则可以通过
-sourcepath来设定，默认情况下-sourcepath和-classpath的路径一样。在编译的过程中，若需要相关java类的则首先在sourcefiles或@files列出的java源码文件中查找并编译，如果没找到，就在-sourcepath指定的路径中查找java源码文件，这时无论找没找到都会继续在类路径中进行查找。如果在sourcepath中找到了java源码文件，但是在类路径中没有找到了相关的类，或找的类位于包文件（jar或zip）中,
或找的类并不是在包文件中，但源码文件比该类文件新，这时会对源码文件进行编译，而且编译生成的类文件将会和你指定要进行编译的java源码所生成的类文件位于同一根目录。否则，除了即没找到java源码文件也没找到相关类就编译失败外，直接载入相关类就可以了。因此你得至少要指定一个要编译的java源文件。它并不是指定sourecfiles或@files中指定的要编译的java源码文件的根目录。与类路径一样，java源码路径项用分号 (;) 进行分隔，它们可以是class文件的根目录、JAR 归档文件或 ZIP 归档文件。
示例8：
javac -sourcepath src -d classes src\com\robin\Hello.java
示例9：
javac -cp lib\Util.zip -sourcepath src -d classes src\com\robin\*.java

关于编译器编译java源码的详细过程可开启-verbose进行参看，关于-verbose的详细内存请参照《javac命令详解（下）》
-source和-target
-source 版本
当你从sun安装了某个版本的JDK，而其实该JDK却包含多个版本的编译器。-source参数就是指定用哪个版本的编译器对java源码进行编译。如果你的java源码不符合该版本编译器的规范的话，当然就不能编译通过。
-target 版本
该命令用于指定生成的class文件将保证和哪个版本的虚拟机进行兼容。我们可以通过-target 1.2来保证生成的class文件能在1.2虚拟机上进行运行，但是1.1的虚拟机就不能保证了。因为java虚拟机的向前兼容行，1.5的虚拟机当然也可以运行通过-target 1.2让生成的class文件。
每个版本编译器的默认-target版本是不太一样的，
比如：
JDK1.2版本编译器支持-target 1.1,-target 1.2,-target 1.3,-target 1.4,-target 1.5,-target 1.6,它默认的就是1.1
JDK1.4版本编译器只支持-target 1.4 和-target 1.5
JDK1.5版本编译器就只支持-target 1.5
示例10
javac -cp lib\Util.zip -sourcepath src -source 1.2 -target 1.1 -d classes src\com\robin\*.java
javac -cp lib\Util.zip -sourcepath src -source 1.2 -target 1.3 -d classes src\com\robin\*.java
javac -cp lib\Util.zip -sourcepath src -source 1.2 -target 1.4 -d classes src\com\robin\*.java
javac -cp lib\Util.zip -sourcepath src -source 1.2 -target 1.5 -d classes src\com\robin\*.java
javac -cp lib\Util.zip -sourcepath src -source 1.2 -target 1.6 -d classes src\com\robin\*.java
示例11
javac -cp lib\Util.zip -sourcepath src -source 1.4 -target 1.4 -d classes src\com\robin\*.java
javac -cp lib\Util.zip -sourcepath src -source 1.4 -target 1.5 -d classes src\com\robin\*.java
 

-deprecation
如果java源码中使用了的不鼓励使用的类或类的Field或类的方法或类的方法覆盖，那么如果使用了该参数，将显示关于此的的详细信息,否则只有个简单的Note.
示例12：
D:\project\test>javac -cp lib\Util.zip -sourcepath src -source 1.2 -target 1.6 -
d classes src\com\robin\*.java
Note: src\com\robin\Hello.java uses or overrides a deprecated API.
Note: Recompile with -Xlint:deprecation for details.

D:\project\test>javac -cp lib\Util.zip -sourcepath src -deprecation -d classes s
rc\com\robin\*.java
src\com\robin\Hello.java:11: warning: [deprecation] destroy() in java.lang.Threa
d has been deprecated
                t.destroy();
                 ^
1 warning

 

-encoding
设置源文件编码名称，例如UTF-8。若未指定 -encoding 选项，则使用平台缺省的编码方式。

java的debug选项 -g

-g-Generate all debugging information, including local variables. By default, only line number and source file information is generated.在class文件中生成所有调试信息，包括局部变量的信息。默认的话，只写入源码的行号和源文件信息。 
    -g:none-Do not generate any debugging information.不生成任何调试信息。 
    -g:(lines,vars,source)-只生成部分调试信息（源码行号，变量，源文件信息）。那我们在分别介绍下lines,vars,source的含义。 

-g
生成所有的调试信息，包括局部变量。缺省情况下，只生成行号和源文件信息。
-g:none
不生成任何调试信息。
-g:{关键字列表}
只生成某些类型的调试信息，这些类型由逗号分隔的关键字列表所指定。有效的关键字有：
source
源文件调试信息
lines
行号调试信息
vars
局部变量调试信息
-nowarn
禁用警告信息。
--------------------- 

原文：https://blog.csdn.net/fjjjyf/article/details/84020914