[ options ] [ sourcefiles ] [ @files ]

参数可按任意次序排列。

命令行选项。

一个或多个要编译的源档案（例如 MyClass.java）。

javac 工具读取用 Java 程式语言编写的类和接口定义，并将它们编译成位元组码类档案。

有两种方法可将原始码档案名称传递给 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.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 直接使用类档案。

只要类档案比源档案旧， javac 就认为它已过时。（ -Xdepend 选项指定相对来说较慢但却比较可靠的过程。）

javac 可以隐式编译一些没有在命令行中提及的源档案。用 -verbose 选项可跟蹤自动编译。

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

例如，可以在名为 sourcefiles 的档案中列出所有源档案的名称。该档案可能形如：

MyClass1.java

MyClass2.java

MyClass3.java

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

C:> javac @sourcefiles

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

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

若未指定 -sourcepath 选项（见下文），则将在用户类路径中查找类档案和源档案。

设定输出类档案的位置。如果某个类是一个包的组成部分，则 javac 将把该类档案放入反映包名的子目录中，必要时创建目录。例如，如果指定 -d c:\myclasses 并且该类名叫 com.mypackage.MyClass，那幺类档案就叫作 c:\myclasses\com\mypackage\MyClass.class。

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

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

显示每种不鼓励使用的API（包含成员和类）的使用或覆盖情况说明。没有给出 -deprecation 选项的话， javac 将显示这类源档案的名称：这些源档案使用或覆盖了不鼓励使用的API。

设定源档案编码名称，例如 EUCJIS/SJIS。若未指定 -encoding 选项，则使用平台预设的转换器。

在windows dos环境下编译NetBeans建立的源档案需要加上参数 -encoding utf-8。

生成所有的调试信息，包括局部变数。预设情况下，只生成行号和源档案信息。

不生成任何调试信息。

只生成某些类型的调试信息，这些类型由逗号分隔的关键字列表所指定。有效的关键字有：

source

源档案调试信息

lines

行号调试信息

vars

局部变数调试信息

-nowarn

禁用警告信息。

最佳化代码，缩短执行时间。使用 -O 选项可能使编译速度下降，生成更大的类档案并使程式难以调试。

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

指定用来查找类或接口定义的原始码路径。与用户类路径一样，多个源路径项用分号 “ ; ” 进行分隔，它们可以是目录、JAR 归档档案或 ZIP 归档档案。如果使用包，那幺目录或归档档案中的本地路径名必须反映包名。（注意：通过类路径查找的类，如果找到了其源档案，则可能会自动被重新编译。）

冗长输出。它包括了每个所载入的类和每个所编译的源档案的有关信息。

预设情况下，类是根据与 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 归档档案中查找类档案。

显示非标準选项的有关信息并退出。

递归地搜寻所有可获得的类，以寻找要重编译的最新源档案。该选项将更可靠地查找需要编译的类，但会使编译进程的速度大为减慢。

将编译器信息送到System.out 中。预设情况下，编译器信息送到 System.err 中。

说明如何搜寻路径和标準扩展以查找源档案和类档案。

将选项传给 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);

}

}

}

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 选项可确保生成的类档案与 1.1 版的虚拟机兼容。在 JDK1.2 中， 预设情况下 javac 编译生成的档案是与 1.1 版的虚拟机兼容的，因此并非严格地需要该选项。然而，由于别的编译器可能採用其它的预设设定，所以提供这一选项将不失为是个好习惯。

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

- Java 应用程式启动器

- Java 应用程式调试程式

- C 头档案和 stub 档案生成器

- 类档案解析器

- API 文档生成器

- JAR 归档工具 Java 扩展框架