JAVAC 命令使用方法

时间 2019-11-26

原文原文链接

结构

javac [ options ] [ sourcefiles ] [ @files ]
參数可按随意次序排列。html

options

命令行选项。

sourcefiles

一个或多个要编译的源文件（好比 MyClass.java）。

@files

一个或多个对源文件进行列表的文件。

说明

javacjava

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

假设源文件数量少，在命令行上列出文件名称就能够。

假设源文件数量多，则将源文件名称列在一个文件里，名称间用空格或回车行来进行分隔。而后在 javac 命令行中使用该列表文件名称，文件名称前冠以 @ 字符。

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

内部类定义产生附加的类文件。这些类文件的名称将内部类和外部类的名称结合在一块儿，好比 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。spa

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

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

搜索结果仅仅生成类文件而沒有源文件： javac 使用类文件。

搜索结果仅仅生成源文件而沒有类文件： javac 编译源文件并使用由今生成的类文件。

搜索结果既生成源文件又生成类文件：肯定类文件是否过期。若类文件已过期，则 javac 又一次编译源文件并使用更新后的类文件。不然， javac 直接使用类文件。
缺省状况下，仅仅要类文件比源文件旧， javac 就以为它已过期。（ -Xdepend 选项指定相对来讲较慢但却比較可靠的过程。）
javac

注意： javac 可以隐式编译一些沒有在命令行中说起的源文件。用 -verbose 选项可跟踪本身主动编译。

文件列表

为缩短或简化 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: {keyword列表}

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

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 版的虚拟机兼容的，所以并不是严格地需要该选项。然而，由于别的编译器可能採用其余的缺省设置，因此提供这一选项将不失为是个好习惯。