JAVAC 命令详解

转自：http://jeffchen.iteye.com/blog/395671

结构

javac [ options ] [ sourcefiles ] [ @files ]

参数可按任意次序排列。

options命令行选项。 sourcefiles一个或多个要编译的源文件（例如 MyClass.java）。 @files一个或多个对源文件进行列表的文件。 

说明

javac

有两种方法可将源代码文件名传递给 javac： 

• 若是源文件数量少，在命令行上列出文件名便可。
• 若是源文件数量多，则将源文件名列在一个文件中，名称间用空格或回车行来进行分隔。而后在 javac 命令行中使用该列表文件名，文件名前冠以 @ 字符。 

源代码文件名称必须含有 .java 后缀，类文件名称必须含有 .class 后缀，源文件和类文件都必须有识别该类的根名。例如，名为 MyClass 的类将写在名为 MyClass.java的源文件中，并被编译为字节码类文件 MyClass.class。

内部类定义产生附加的类文件。这些类文件的名称将内部类和外部类的名称结合在一块儿，例如 MyClass$MyInnerClass.class。

应当将源文件安排在反映其包树结构的目录树中。例如，若是将全部的源文件放在 /workspace 中，那么 com.mysoft.mypack.MyClass 的代码应该在 \workspace\com\mysoft\mypack\MyClass.java 中。

缺省状况下，编译器将每一个类文件与其源文件放在同一目录中。可用 -d 选项（请参阅后面的

选项 ）指定其它目标目录。 工具读取用 Java 编程语言编写的类和接口定义，并将它们编译成字节码类文件。

查找类型

当编译源文件时，编译器经常须要它尚未识别出的类型的有关信息。对于源文件中使用、扩展或实现的每一个类或接口，编译器都须要其类型信息。这包括在源文件中没有明确说起、但经过继承提供信息的类和接口。

例如，当扩展 java.applet.Applet 时还要用到 Applet 的祖先类：java.awt.Panel 、 java.awt.Container、 java.awt.Component 和 java.awt.Object。

当编译器须要类型信息时，它将查找定义类型的源文件或类文件。编译器先在自举类及扩展类中查找，而后在用户类路径中查找。用户类路径经过两种途径来定义：经过设置 CLASSPATH 环境变量或使用 -classpath 命令行选项。（有关详细资料，请参阅设置类路径）。若是使用 -sourcepath 选项，则编译器在 sourcepath 指定的路径中查找源文件；不然，编译器将在用户类路径中查找类文件和源文件。可用-bootclasspath 和 -extdirs 选项来指定不一样的自举类或扩展类；参阅下面的联编选项。

成功的类型搜索可能生成类文件、源文件或二者兼有。如下是 javac 对各类情形所进行的处理： 

• 搜索结果只生成类文件而没有源文件： javac 使用类文件。
• 搜索结果只生成源文件而没有类文件： javac 编译源文件并使用由今生成的类文件。
• 搜索结果既生成源文件又生成类文件： 肯定类文件是否过期。若类文件已过期，则 javac 从新编译源文件并使用更新后的类文件。不然， javac 直接使用类文件。

  缺省状况下，只要类文件比源文件旧， javac 就认为它已过期。（ -Xdepend 选项指定相对来讲较慢但却比较可靠的过程。） 

  javac 

注意： javac 能够隐式编译一些没有在命令行中说起的源文件。用 -verbose 选项可跟踪自动编译。

文件列表

<!-- Don't document @files for arguments other than files, such as options - dps <h2>COMMAND LINE ARGUMENT FILE</h2> -->

为缩短或简化 javac 命令，能够指定一个或多个每行含有一个文件名的文件。在命令行中，采用 '@' 字符加上文件名的方法将它指定为文件列表。当 javac 遇到以 `@' 字符开头的参数时，它对那个文件中所含文件名的操做跟对命令行中文件名的操做是同样的。这使得 Windows 命令行长度再也不受限制。

例如，能够在名为 sourcefiles 的文件中列出全部源文件的名称。该文件可能形如： 

     MyClass1.java
MyClass2.java
MyClass3.java

而后可用下列命令运行编译器：

     C:> javac @sourcefiles

选项

编译器有一批标准选项，目前的开发环境支持这些标准选项，未来的版本也将支持它。还有一批附加的非标准选项是目前的虚拟机实现所特有的，未来可能要有变化。非标准选项以 -X 打头。

标准选项

-classpath  类路径设置用户类路径，它将覆盖  CLASSPATH 环境变量中的用户类路径。若既未指定  CLASSPATH 又未指定  -classpath，则用户类路径由当前目录构成。有关详细信息，请参阅设置类路径。

若未指定 -sourcepath 选项，则将在用户类路径中查找类文件和源文件。

-d  目录设置类文件的目标目录。若是某个类是一个包的组成部分，则  javac 将把该类文件放入反映包名的子目录中，必要时建立目录。例如，若是指定  -d c:\myclasses 而且该类名叫  com.mypackage.MyClass，那么类文件就叫做  c:\myclasses\com\mypackage\MyClass.class。

若未指定 -d 选项，则 javac 将把类文件放到与源文件相同的目录中。

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

-deprecation显示每种不鼓励使用的成员或类的使用或覆盖的说明。没有给出  -deprecation 选项的话，  javac将显示这类源文件的名称：这些源文件使用或覆盖不鼓励使用的成员或类。 -encoding设置源文件编码名称，例如  EUCJIS/SJIS。若未指定  -encoding 选项，则使用平台缺省的转换器。 -g生成全部的调试信息，包括局部变量。缺省状况下，只生成行号和源文件信息。 -g:none不生成任何调试信息。 -g: {关键字列表}只生成某些类型的调试信息，这些类型由逗号分隔的关键字列表所指定。有效的关键字有： source源文件调试信息 lines行号调试信息 vars局部变量调试信息  -nowarn禁用警告信息。 -O优化代码以缩短执行时间。使用  -O 选项可能使编译速度降低、生成更大的类文件并使程序难以调试。

在 JDK 1.2 之前的版本中，javac 的 -g 选项和 -O 选项不能一块儿使用。在 JDK 1.2 中，能够将 -g和 -O 选项结合起来，但可能会获得意想不到的结果，如丢失变量或从新定位代码或丢失代码。-O选项再也不自动打开 -depend 或关闭 -g 选项。一样， -O 选项也再也不容许进行跨类内嵌。

-sourcepath  源路径指定用以查找类或接口定义的源代码路径。与用户类路径同样，源路径项用分号 ( ;) 进行分隔，它们能够是目录、JAR 归档文件或 ZIP 归档文件。若是使用包，那么目录或归档文件中的本地路径名必须反映包名。

注意：经过类路径查找的类，若是找到了其源文件，则可能会自动被从新编译。

-verbose冗长输出。它包括了每一个所加载的类和每一个所编译的源文件的有关信息。 

联编选项

缺省状况下，类是根据与 javac 一块儿发行的 JDK 自举类和扩展类来编译。但 javac 也支持联编，在联编中，类是根据其它 Java平台实现的自举类和扩展类来进行编译的。联编时， -bootclasspath 和 -extdirs的使用很重要；请参阅下面的联编程序示例。 

-target  版本生成将在指定版本的虚拟机上运行的类文件。缺省状况下生成与 1.1 和 1.2 版本的虚拟机都兼容的类文件。JDK 1.2 中的  javac 所支持的版本有： 1.1保证所产生的类文件与 1.1 和 1.2 版的虚拟机兼容。这是缺省状态。 1.2生成的类文件可在 1.2 版的虚拟机上运行，但不能在 1.1 版的虚拟机上运行。  -bootclasspath  自举类路径根据指定的自举类集进行联编。和用户类路径同样，自举类路径项用分号 ( ;) 进行分隔，它们能够是目录、JAR 归档文件或 ZIP 归档文件。 -extdirs  目录根据指定的扩展目录进行联编。 目录是以分号分隔的目录列表。在指定目录的每一个 JAR 归档文件中查找类文件。 

非标准选项

-X显示非标准选项的有关信息并退出。 -Xdepend递归地搜索全部可得到的类，以寻找要重编译的最新源文件。该选项将更可靠地查找须要编译的类，但会使编译进程的速度大为减慢。 -Xstdout将编译器信息送到 System.out 中。缺省状况下，编译器信息送到  System.err 中。 -Xverbosepath说明如何搜索路径和标准扩展以查找源文件和类文件。 -J 选项将 选项传给  javac 调用的  java 启动器。例如，  -J-Xms48m 将启动内存设为 48 兆字节。虽然它不以  -X 开头，但它并非  javac 的‘标准选项’。用  -J 将选项传给执行用 Java 编写的应用程序的虚拟机是一种公共约定。

注意： CLASSPATH 、 -classpath 、 -bootclasspath 和 -extdirs 并 不 指定用于运行 javac 的类。如此滥用编译器的实现一般没有任何意义并且老是很危险的。若是确实须要这样作，可用 -J选项将选项传给基本的 java 启动器。

程序示例

编译简单程序

一个源文件 Hello.java ，它定义了一个名叫 greetings.Hello 的类。greetings 目录是源文件和类文件二者的包目录，且它不是当前目录。这让咱们可使用缺省的用户类路径。它也使咱们不必用 -d 选项指定单独的目标目录。

C:> dir
greetings/
C:> dir greetings
Hello.java
C:> cat greetings\Hello.java
package greetings;
public class Hello {
public static void main(String[] args) {
for (int i=0; i < args.length; i++) {
System.out.println("Hello " + args[i]);
}
}
}
C:> javac greetings\Hello.java
C:> dir greetings
Hello.class   Hello.java
C:> java greetings.Hello World Universe Everyone
Hello World
Hello Universe
Hello Everyone

编译多个源文件

该示例编译 greetings 包中的全部源文件。

C:> dir
greetings\
C:> dir greetings
Aloha.java         GutenTag.java      Hello.java         Hi.java
C:> javac greetings\*.java
C:> dir greetings
Aloha.class         GutenTag.class      Hello.class         Hi.class
Aloha.java          GutenTag.java       Hello.java          Hi.java

指定用户类路径

对前面示例中的某个源文件进行更改后，从新编译它： 

C:> cd
\examples
C:> javac greetings\Hi.java

因为 greetings.Hi 引用了 greetings 包中其它的类，编译器须要找到这些其它的类。上面的示例能运行是由于缺省的用户类路径恰好是含有包目录的目录。可是，假设咱们想从新编译该文件而且不关心咱们在哪一个目录中的话， 咱们须要将 \examples 添加到用户类路径中。能够经过设置 CLASSPATH 达到此目的，但这里咱们将使用 -classpath 选项来完成。

C:>javac -classpath \examples \examples\greetings\Hi.java

若是再次将 greetings.Hi 改成使用标题实用程序，该实用程序也须要经过用户类路径来进行访问： 

C:>javac -classpath \examples:\lib\Banners.jar \
\examples\greetings\Hi.java

要执行 greetings 中的类，须要访问 greetings 和它所使用的类。

C:>java -classpath \examples:\lib\Banners.jar greetings.Hi

将源文件和类文件分开

将源文件和类文件置于不一样的目录下常常是颇有意义的，特别是在大型的项目中。咱们用 -d 选项来指明单独的类文件目标位置。因为源文件不在用户类路径中，因此用 -sourcepath 选项来协助编译器查找它们。

C:> dir
classes\  lib\      src\
C:> dir src
farewells\
C:> dir src\farewells
Base.java      GoodBye.java
C:> dir lib
Banners.jar
C:> dir classes
C:> javac -sourcepath src -classpath classes:lib\Banners.jar \
src\farewells\GoodBye.java -d classes
C:> dir classes
farewells\
C:> dir classes\farewells
Base.class      GoodBye.class

注意：编译器也编译了 src\farewells\Base.java，虽然咱们没有在命令行中指定它。要跟踪自动编译，可以使用 -verbose 选项。

联编程序示例

这里咱们用 JDK 1.2 的 javac 来编译将在 1.1 版的虚拟机上运行的代码。

C:> javac -target 1.1 -bootclasspath jdk1.1.7\lib\classes.zip \
-extdirs "" OldCode.java

-target 1.1

JDK 1.2 javac 在缺省状态下也将根据 1.2 版的自举类来进行编译，所以咱们须要告诉 javac 让它根据 JDK 1.1 自举类来进行编译。可用 -bootclasspath 和 -extdirs 选项来达到此目的。不这样作的话，可能会使编译器根据 1.2 版的 API 来进行编译。因为 1.1 版的虚拟机上可能没有该 1.2 版的 API，所以运行时将出错。

选项可确保生成的类文件与 1.1 版的虚拟机兼容。在 JDK1.2 中， 缺省状况下  javac 编译生成的文件是与 1.1 版的虚拟机兼容的，所以并不是严格地须要该选项。然而，因为别的编译器可能采用其它的缺省设置，因此提供这一选项将不失为是个好习惯。