jar 命令详解

jar 是随 JDK 安装的，在 JDK 安装目录下的 bin 目录中，Windows 下文件名为 jar.exe，Linux 下文件名为 jar。它的运行须要用到 JDK 安装目录下 lib 目录中的 tools.jar 文件。不过咱们除了安装 JDK 什么也不须要作，由于 SUN 已经帮咱们作好了。咱们甚至不须要将 tools.jar 放到 CLASSPATH 中。 

使用不带任何的 jar 命令咱们能够看到 jar 命令的用法以下： 

 

jar {ctxu}[vfm0M] [jar-文件] [manifest-文件] [-C 目录] 文件名 ... 

其中 {ctxu} 是 jar 命令的子命令，每次 jar 命令只能包含 ctxu 中的一个，它们分别表示： 

-c 建立新的 JAR 文件包 

-t 列出 JAR 文件包的内容列表 

-x 展开 JAR 文件包的指定文件或者全部文件 

-u 更新已存在的 JAR 文件包 (添加文件到 JAR 文件包中) 

[vfm0M] 中的选项能够任选，也能够不选，它们是 jar 命令的选项参数 

-v 生成详细报告并打印到标准输出 

-f 指定 JAR 文件名，一般这个参数是必须的 

-m 指定须要包含的 MANIFEST 清单文件 

-0 只存储，不压缩，这样产生的 JAR 文件包会比不用该参数产生的体积大，但速度更快 

-M 不产生全部项的清单（MANIFEST〕文件，此参数会忽略 -m 参数 

[jar-文件] 即须要生成、查看、更新或者解开的 JAR 文件包，它是 -f 参数的附属参数 

[manifest-文件] 即 MANIFEST 清单文件，它是 -m 参数的附属参数 

[-C 目录] 表示转到指定目录下去执行这个 jar 命令的操做。它至关于先使用 cd 命令转该目录下再执行不带 -C 参数的 jar 命令，它只能在建立和更新 JAR 文件包的时候可用。 

文件名 ... 指定一个文件/目录列表，这些文件/目录就是要添加到 JAR 文件包中的文件/目录。若是指定了目录，那么 jar 命令打包的时候会自动把该目录中的全部文件和子目录打入包中。 

下面举一些例子来讲明 jar 命令的用法： 

1) jar cf test.jar test 

该命令没有执行过程的显示，执行结果是在当前目录生成了 test.jar 文件。若是当前目录已经存在 test.jar，那么该文件将被覆盖。 

2) jar cvf test.jar test 

该命令与上例中的结果相同，可是因为 v 参数的做用，显示出了打包过程，以下： 

标明清单(manifest) 

增长：test/(读入= 0) (写出= 0)(存储了 0%) 

增长：test/Test.class(读入= 7) (写出= 6)(压缩了 14%) 

3) jar cvfM test.jar test 

该命令与 2) 结果相似，但在生成的 test.jar 中没有包含 META-INF/MANIFEST 文件，打包过程的信息也略有差异： 

增长：test/(读入= 0) (写出= 0)(存储了 0%) 

增长：test/Test.class(读入= 7) (写出= 6)(压缩了 14%) 

4) jar cvfm test.jar manifest.mf test 

运行结果与 2) 类似，显示信息也相同，只是生成 JAR 包中的 META-INF/MANIFEST 内容不一样，是包含了 manifest.mf 的内容 

5) jar tf test.jar 

在 test.jar 已经存在的状况下，能够查看 test.jar 中的内容，如对于 2) 和 3) 生成的 test.jar 分别应该此命令，结果以下； 

对于 2) 

META-INF/ 

META-INF/MANIFEST.MF 

test/ 

test/Test.class 

对于 3) 

test/ 

test/Test.class 

6) jar tvf test.jar 

除显示 5) 中显示的内容外，还包括包内文件的详细信息，如： 

0 Wed Jun 19 15:39:06 GMT 2002 META-INF/ 

86 Wed Jun 19 15:39:06 GMT 2002 META-INF/MANIFEST.MF 

0 Wed Jun 19 15:33:04 GMT 2002 test/ 

7 Wed Jun 19 15:33:04 GMT 2002 test/Test.class 

7) jar xf test.jar 

解开 test.jar 到当前目录，不显示任何信息，对于 2) 生成的 test.jar，解开后的目录结构以下： 

== 

|-- META-INF 

| `-- MANIFEST 

`-- test 

`--Test.class 

8) jar xvf test.jar 

运行结果与 7) 相同，对于解压过程有详细信息显示，如： 

建立：META-INF/ 

展开：META-INF/MANIFEST.MF 

建立：test/ 

展开：test/Test.class 

9) jar uf test.jar manifest.mf 

在 test.jar 中添加了文件 manifest.mf，此使用 jar tf 来查看 test.jar 能够发现 test.jar 中比原来多了一个 manifest。这里顺便提一下，若是使用 -m 参数并指定 manifest.mf 文件，那么 manifest.mf 是做为清单文件 MANIFEST 来使用的，它的内容会被添加到 MANIFEST 中；可是，若是做为通常文件添加到 JAR 文件包中，它跟通常文件无异。 

10) jar uvf test.jar manifest.mf 

与 9) 结果相同，同时有详细信息显示，如： 

增长：manifest.mf(读入= 17) (写出= 19)(压缩了 -11%) 

4. 关于 JAR 文件包的一些技巧 

1) 使用 unzip 来解压 JAR 文件 

在介绍 JAR 文件的时候就已经说过了，JAR 文件实际上就是 ZIP 文件，因此可使用常见的一些解压 ZIP 文件的工具来解压 JAR 文件，如 Windows 下的 WinZip、WinRAR 等和 Linux 下的 unzip 等。使用 WinZip 和 WinRAR 等来解压是由于它们解压比较直观，方便。而使用 unzip，则是由于它解压时可使用 -d 参数指定目标目录。 

在解压一个 JAR 文件的时候是不能使用 jar 的 -C 参数来指定解压的目标的，由于 -C 参数只在建立或者更新包的时候可用。那么须要将文件解压到某个指定目录下的时候就须要先将这具 JAR 文件拷贝到目标目录下，再进行解压，比较麻烦。若是使用 unzip，就不须要这么麻烦了，只须要指定一个 -d 参数便可。如： 

unzip test.jar -d dest/ 

2) 使用 WinZip 或者 WinRAR 等工具建立 JAR 文件 

上面提到 JAR 文件就是包含了 META-INF/MANIFEST 的 ZIP 文件，因此，只须要使用 WinZip、WinRAR 等工具建立所须要 ZIP 压缩包，再往这个 ZIP 压缩包中添加一个包含 MANIFEST 文件的 META-INF 目录便可。对于使用 jar 命令的 -m 参数指定清单文件的状况，只须要将这个 MANIFEST 按须要修改便可。 

3) 使用 jar 命令建立 ZIP 文件 

有些 Linux 下提供了 unzip 命令，但没有 zip 命令，因此须要能够对 ZIP 文件进行解压，即不能建立 ZIP 文件。如要建立一个 ZIP 文件，使用带 -M 参数的 jar 命令便可，由于 -M 参数表示制做 JAR 包的时候不添加 MANIFEST 清单，那么只须要在指定目标 JAR 文件的地方将 .jar 扩展名改成 .zip 扩展名，建立的就是一个彻彻底底的 ZIP 文件了，如将上一节的第 3) 个例子略做改动： 

jar cvfM test.zip test