javac命令详解（上）

摘自http://blog.csdn.net/hudashi/article/details/7058998

 

javac命令详解（上）                          

 

javac命令用与编译java源码文件，其语法格式如下：

javac [ options ] [ sourcefiles ] [ @files ]

参数可按任意次序排列。

options                       命令行选项。

sourcefiles                 一个或多个要编译的源文件（例如 MyClass.java）。

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

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

一种是通过sourcefiles参数，直接给出要编译的源文件

如果源文件数量少，可以用这种方式，在命令行上列出文件名即可。文件与文件之间用空格非分开就可以了。

实例1

javac -d classes src\com\robin\Hello.java src\com\robin\People.java src\com\hubin\Util.java。

其实这里的源码文件每个都是单独的参数，如果文件路径包括有空格，可以用双引号把该文件名括起来。

比如上面的命令可以写成下面的样子：

示例2

javac -d classes "src\com\robin\Hello.java" "src\com\robin\People.java" "src\com\hubin\Util.java"

在没使用分号的情况下，对相同路径下的Java源码文件可以使用统配符，比如示例1可以写成：

示例3

javac -d classes src\com\robin\*.java src\com\hubin\Util.java

一种是通过@files参数

为缩短或简化javac命令，可以把要编译的java源文件名列在一个文件，文件名之间用空格或回车进行分割。然后在javac命令行中，可以用'@' 字符加上包含有要编译java源文件名的文件名来指定要编译的java源文件。因为javac当遇到以  `@' 字符，它就会对该字符后的文件所列出的所有java源文件进行编译。这种形式适用于java源文件很多的情况。

比如，我们把示例1要编译的源文件名包含在src.txt文件中。

示例4

src.txt文件：

src\com\robin\Hello.java src\com\robin\People.java

src\com\hubin\Util.java

然后运行如下的javac命令：

javac -d classes @src.txt

当然我们可以在src.txt中用双引号把单个要编译的java源码文件括起来，

但是这时路径直接的分隔符“\”就要写成"\\"的形式了。

示例5

src.txt文件

"src\\com\\robin\\Hello.java" "src\\com\\robin\\People.java"

"src\\com\\hubin\\Util.java"

这时javac命令仍然同示例3.

命令选项options

路径

-d 目录

该选项用于指定生成的class目标文件的目录。如果某个类是一个包的组成部分，则 javac 将把该类文件放入反映包名的子目录中，必要时创建目录。比如，示例1中的class目标目录就放在classes下，Hello.class和People.class位于classes\com\robin下，Util.class位于classes\com\hubin目录下。

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

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

-bootclasspath，-extdirs，-classpath和-cp

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

　　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 选项，则使用平台缺省的编码方式。

-g

生成所有的调试信息，包括局部变量。缺省情况下，只生成行号和源文件信息。

-g:none

不生成任何调试信息。

-g:{关键字列表}

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

source

源文件调试信息

lines

行号调试信息

vars

局部变量调试信息

-nowarn

禁用警告信息。