README

Closure Compiler是一个使JavaScript下载和运行更快的工具。它是一个真正的JavaScript编译器。它不是从源语言编译到机器代码，而是从JavaScript编译到更好的JavaScript。它会解析你的JavaScript，分析它，移除死代码，并重写和最小化剩余的部分。它还会检查语法、变量引用和类型，并警告常见的JavaScript陷阱。

入门

• 下载最新版本 (发布详情在此)
• 下载特定版本。也可以通过以下方式获得：
  • Maven
  • NPM
• 请访问Google Developers Site以获取文档，包括从命令行运行编译器的说明。

获取帮助的选项

1. 在Closure Compiler Discuss Group中发帖
2. 在Stack Overflow上提问
3. 查阅FAQ

自己构建

注意：Closure Compiler需要Java 7或更高版本。

使用Ant

1. 下载Ant构建工具。

2. 在源代码树的根目录中，有一个名为build.xml的Ant文件。要使用它，导航到同一目录并输入以下命令：

   ant jar
   

   这将生成一个名为build/compiler.jar的jar文件。

使用Eclipse

1. 下载并打开Eclipse IDE。
2. 导航到文件 > 新建 > 项目 ...并创建一个Java项目。给项目命名。
3. 选择从现有源创建项目并选择已签出的源代码树的根目录作为现有目录。
4. 导航到 build.xml 文件。您将在大纲窗格中看到所有构建规则。运行 jar 规则以在 build/compiler.jar 中构建编译器。

运行

在命令行中，在此项目的根目录下输入

java -jar build/compiler.jar

这将以交互模式启动编译器。输入

var x = 17 + 25;

然后按“Enter”，然后按“Ctrl-Z”（在Windows上）或“Ctrl-D”（在Mac或Linux上）并再次按“Enter”。编译器将响应

var x=42;

Closure Compiler 有许多选项，用于从文件读取输入，将输出写入文件，检查您的代码以及运行优化。要了解更多信息，请输入

java -jar compiler.jar --help

有关运行 Closure Compiler 的更详细信息，请参阅 文档。

编译多个脚本

如果您有多个脚本，您应该使用一个编译命令将它们全部一起编译。

java -jar compiler.jar --js_output_file=out.js in1.js in2.js in3.js ...

您还可以使用 minimatch 风格的 glob。

# Recursively include all js files in subdirs
java -jar compiler.jar --js_output_file=out.js 'src/**.js'

# Recursively include all js files in subdirs, exclusing test files.
# Use single-quotes, so that bash doesn't try to expand the '!'
java -jar compiler.jar --js_output_file=out.js 'src/**.js' '!**_test.js'

Closure Compiler 将根据命令行中传递的顺序连接文件。

如果您使用 glob 或许多文件，您可能开始遇到脚本之间依赖关系管理的问题。在这种情况下，您应该使用 Closure Library。它包含用于强制脚本之间依赖关系的函数，并且 Closure Compiler 将自动重新排序输入。

如何贡献

报告一个错误

1. 首先确保这是一个真正的错误，而不是 Closure Compiler 的工作方式（特别是对于 ADVANCED_OPTIMIZATIONS）。

• 查看 官方文档
• 查阅FAQ
• 在 Stack Overflow 和 Closure Compiler 讨论组 中搜索

1. 如果您仍然认为您已经发现了一个错误，请确保还没有人报告过。查看 已知问题 列表。
2. 如果尚未报告，请发布一个新的问题。确保添加足够的细节，以便可以重现错误。重现代码越小越好。

建议一个功能

1. 查阅 常见问题解答 以确保您想要的行为不是明确排除的（例如字符串内联）。
2. 确保没有人提出过相同的要求。查看 已知问题 列表。
3. 阅读有关 接受哪种类型的特性请求 的信息。
4. 将您的请求作为问题提交。

提交补丁

1. 所有贡献者都必须签署贡献者许可协议。有关详细信息，请参阅 CONTRIBUTORS 文件。
2. 为确保您的更改类型将被接受，请在Closure Compiler 讨论组上询问您的补丁。
3. 分支仓库。
4. 进行您的更改。
5. 提交您的更改的拉取请求。项目开发者将审查您的工作，然后将其合并到项目中。

Closure Compiler 许可证

版权所有 2009 The Closure Compiler 作者。

根据 Apache 许可证 2.0 版（“许可证”）；除非遵守许可证，否则不得使用此文件。您可以在 https://apache.ac.cn/licenses/LICENSE-2.0 获取许可证副本。

除非适用法律要求或书面同意，否则在许可证下分发的软件按“原样”基础分发，不提供任何形式的保证或条件，无论是明示的还是暗示的。有关许可证的权限和限制的具体语言，请参阅许可证。

依赖项许可证

Rhino

Args4j

Guava 库

JSR 305

JUnit

Protocol Buffers

Truth

Ant

GSON

Node.js Closure Compiler Externs