Closure Compiler 开源项目安装与使用指南

目录结构及介绍

在克隆或下载了 Closure Compiler 的 GitHub 仓库之后，你可以看到以下主要目录和文件：

• src: 这是编译器的主要源代码所在的位置，包括各种类、接口以及与核心功能相关的实现。
• test: 包含测试案例，用于确保编译器的功能正确性和性能优化。
• java/com/google/javascript/jscomp/: 此目录包含了编译器的核心 Java 类，负责解析、优化和压缩 JavaScript 代码。
• java/com/google/javascript/jscomp/compiler/: 编译器引擎相关类，处理输入并产生优化后的输出。

启动文件介绍

Closure Compiler 提供了一个可执行的 JAR 文件来运行编译过程。在 out 或者 bin 目录下通常可以找到这个 JAR 文件，其名称可能是类似 compiler.jar 的形式。

如何启动

要启动 Closure Compiler，你需要具备 JDK 环境并且命令行支持运行 Java 应用程序。以下是启动 Closure Compiler 的基本命令示例：

java -jar path/to/compiler.jar --js input.js --js_output_file output.min.js

在这个命令中:

• -jar: 告诉 Java 虚拟机（JVM）从给定的 .jar 文件中读取主类。
• path/to/compiler.jar: 指向 Closure Compiler 的 JAR 文件路径。
• --js: 指定要被优化和压缩的 JavaScript 输入文件路径。
• --js_output_file: 指定编译后的优化代码将被写入的输出文件路径。

配置文件介绍

虽然 Closure Compiler 可以通过命令行参数进行配置，但在更复杂的工作流中，使用配置文件可以使管理编译设置更加容易。配置文件允许你指定一系列选项，例如编译级别、输入和输出文件等。

一个典型的配置文件可能看起来像这样：

// ==ClosureCompiler==
// @compilation_level SIMPLE_OPTIMIZATIONS
// @language ECMASCRIPT_2018
// @output_file_name main.min.js
// @rewrite_polyfills false
// @warning_level VERBOSE
// ==/ClosureCompiler==

在这个例子中，

• @compilation_level: 定义编译器优化的程度。有三个可用级别：WHITESPACE_ONLY, SIMPLE_OPTIMIZATIONS 和 ADVANCED_OPTIMIZATIONS。
• @language: 定义输入代码使用的 JavaScript 版本。
• @output_file_name: 设置输出文件名。
• @rewrite_polyfills: 决定是否重写 polyfills 来适应更广泛的浏览器兼容性。
• @warning_level: 控制警告消息的数量，包括 QUIET、DEFAULT 和 VERBOSE。

配置文件中的每一项都以 @ 符号开头，这使得它们能够在与其他 JavaScript 代码一起打包时不会被编译器误认为常规代码。通过这种方式，你可以在实际的代码库中维护这些设置，或者单独创建一个配置文件并在命令行中引用它。