Часто задаваемые вопросы
Оптимизируйте свои подборки
Сохраняйте и классифицируйте контент в соответствии со своими настройками.
- Что такое Closure Compiler? Зачем его использовать?
- Closure Compiler — это инструмент для ускорения загрузки и выполнения JavaScript. Closure Compiler можно использовать для уменьшения размера JavaScript-файлов и повышения их эффективности.
- Чем Closure Compiler отличается от других существующих компрессоров JavaScript?
Как правило, Closure Compiler должен соответствовать или превосходить другие инструменты минимизации кода по уровню сжатия, а также сокращать время загрузки вашего веб-приложения. Кроме того, Closure Compiler может помочь вам обнаружить синтаксические ошибки во время разработки (а не во время тестирования) и выявить потенциально опасные шаблоны кода.
В простом режиме Closure Compiler должен быть эффективнее других инструментов, поскольку он использует анализ, подобный компилятору, для поиска дополнительных способов минимизации размера кода. Например, Closure Compiler может встраивать функции, используемые лишь в редких случаях, повторно использовать имена переменных и предварительно вычислять константные выражения.
В расширенном режиме Closure Compiler также может использовать добавленные вами аннотации типов для поиска труднообнаружимых ошибок.
- Может ли Closure Compiler компилировать JavaScript, встроенный в HTML?
- Нет. Closure Compiler работает только с файлами, содержащими только JavaScript.
- Могу ли я использовать Closure Compiler вместе с другими минификаторами JavaScript?
Да. Closure Compiler считывает любой корректный код JavaScript и генерирует корректный код JavaScript, поэтому вы можете применить Closure Compiler к файлу JavaScript как до, так и после его обработки другим минификатором.
Помните, что Closure Compiler и другие минификаторы могут иметь свои ожидания относительно входящего кода. Например, минификатор, удаляющий комментарии, может удалить лицензии или информацию об аннотациях, необходимую другому инструменту.
- Как отладить JavaScript, создаваемый Closure Compiler?
- Если ваш скомпилированный код выдаёт ошибки или ведёт себя непредвиденно, вы можете использовать карты исходного кода для отладки проблемы. Карта исходного кода обеспечивает сопоставление скомпилированного и исходного кода, чтобы инструменты разработчика браузера могли отображать ваш исходный код вместо скомпилированного. Чтобы Closure Compiler создал карту исходного кода, передайте флаг
--create_source_map в командной строке. Например:$ java -jar compiler.jar --js example.js --create_source_map ./example-map --js_output_file example-compiled.js
Затем, если вы используете браузер с поддержкой карт исходного кода (например, Chrome или Firefox), вы можете установить точки останова так же, как для нескомпилированного кода, и инструменты разработчика браузера отобразят соответствующую строку кода в исходном коде. Подробнее об инструментах разработчика Chrome, включая информацию о картах исходного кода, см. в разделе «Отладка JavaScript» . - Делает ли компилятор какой-либо компромисс между скоростью выполнения моего приложения и размером загружаемого кода?
- Да. Любой оптимизирующий компилятор идёт на компромиссы. Некоторые оптимизации размера кода приводят к небольшому снижению скорости. Однако разработчики Closure Compiler постарались не увеличивать значительное время выполнения. Некоторые оптимизации компилятора даже сокращают время выполнения (см. следующий вопрос).
- Оптимизирует ли компилятор скорость?
- В большинстве случаев код меньшего размера означает более быстрый код, поскольку время загрузки обычно является наиболее важным фактором скорости веб-приложений. Оптимизации, уменьшающие избыточность, также ускоряют выполнение кода.
- Существуют ли ограничения на размер скомпилированных файлов?
- Веб-сервис компиляции имеет ограничение на максимальный размер файла, но автономное приложение компилятора — нет.
- Доступен ли Closure Compiler для всех платформ?
- Компилятор написан на Java, поэтому он может работать везде, где работает Java.
- Может ли компилятор обрабатывать любой допустимый JavaScript?
- В основном. Некоторые конструкции JavaScript, включая
eval() и with() , могут сделать недействительными предположения, на которых основаны преобразования компилятора. - Насколько хорошо мне нужно знать веб-разработку, чтобы использовать Closure Compiler?
- Closure Compiler — это инструмент для разработки на JavaScript, поэтому для его использования вам необходимо уметь программировать на JavaScript. Однако любой, кто использует JavaScript, может получить от него пользу.
- Как Closure Compiler работает с Closure Library?
- Closure Compiler обеспечивает специальные проверки и оптимизацию кода, использующего Closure Library. Кроме того, служба Closure Compiler может автоматически включать файлы Closure Library. В разделе « Finding Your Way around Closure» описывается синтаксис объявления необходимых частей Closure. Сведения об использовании Closure Library с API см. в справочнике по API. Чтобы использовать Closure Library с приложением Closure Compiler, необходимо сначала загрузить Closure Library . Поддержка Closure Library включена в приложении компилятора по умолчанию.
- Мой код перестаёт работать или компилятор выдаёт ошибки при компиляции с
ADVANCED_OPTIMIZATIONS . Почему? - Использование расширенного режима обычно требует некоторой подготовки и внесения изменений в код. В разделе «Расширенная компиляция и внешние компоненты» объясняется, как обеспечить работу кода с
ADVANCED_OPTIMIZATIONS . - Почему в скомпилированных скриптах присутствуют случайные переводы строк?
- Компилятор Closure Compiler намеренно добавляет переносы строк примерно каждые 500 символов. Брандмауэры и прокси-серверы иногда повреждают или игнорируют большие файлы JavaScript с очень длинными строками. Добавление переносов строк каждые 500 символов предотвращает эту проблему. Удаление переносов строк не влияет на семантику скрипта. Влияние на размер кода незначительно, и компилятор оптимизирует размещение переносов строк, так что потери в размере кода становятся ещё меньше при сжатии файлов с помощью gzip.
- В моём исходном коде есть уведомления об авторских правах или текст лицензии с открытым исходным кодом, которые должны присутствовать. Как запретить Closure Compiler удалять этот текст?
- Closure Compiler поддерживает тег
@license для JSDoc. Добавьте тег @license к любому комментарию JSDoc, чтобы сохранить его в выводе компилятора. Подробнее см. в статье «Аннотирование JavaScript для Closure Compiler» .
Если не указано иное, контент на этой странице предоставляется по лицензии Creative Commons "С указанием авторства 4.0", а примеры кода – по лицензии Apache 2.0. Подробнее об этом написано в правилах сайта. Java – это зарегистрированный товарный знак корпорации Oracle и ее аффилированных лиц.
Последнее обновление: 2025-07-24 UTC.
[null,null,["Последнее обновление: 2025-07-24 UTC."],[[["\u003cp\u003eThe Closure Compiler is a tool for making JavaScript download and run faster by reducing file size and improving efficiency.\u003c/p\u003e\n"],["\u003cp\u003eIt offers greater compression than standard minifiers and helps identify syntax errors and potential bugs during development.\u003c/p\u003e\n"],["\u003cp\u003eThe Closure Compiler works with any valid JavaScript and can be used alongside other minifiers for enhanced optimization.\u003c/p\u003e\n"],["\u003cp\u003eSource maps enable debugging of compiled code by providing a mapping back to the original source.\u003c/p\u003e\n"],["\u003cp\u003eWhile prioritizing download speed, the compiler also performs optimizations to enhance execution speed without significant runtime overhead.\u003c/p\u003e\n"]]],[],null,["# Frequently Asked Questions\n\n- [What is the Closure Compiler? Why should I use it?](#what)\n- [How is the Closure Compiler different\n from the other JavaScript compressors that are out there?](#how-different)\n- [Can the Closure Compiler compile JavaScript that's embedded in HTML?](#tags)\n- [Can I use the Closure Compiler together with other JavaScript\n minifiers?](#other-minifiers)\n- [How can I debug the JavaScript that the Closure Compiler produces?](#sourcemaps)\n- [Does the compiler make any trade-off between my application's\n execution speed and download code size?](#tradeoffs)\n- [Does the compiler optimize for speed?](#speed)\n- [Are there any restrictions on the size of the files that can be compiled?](#size-restrictions)\n- [Is the Closure Compiler available for all platforms?](#platforms)\n- [Can the Compiler process any legal JavaScript?](#restrictions)\n- [How does the Closure Compiler work with\n the Closure Library?](#how-closure)\n- [My code stops working or the Compiler produces\n errors when I compile\n with `ADVANCED_OPTIMIZATIONS`. Why?](#advanced)\n- [Why are there random line feeds in\n compiled scripts?](#linefeeds)\n- [I have copyright notices or open source license\n text that must appear in my source code. How do I keep the Closure\n Compiler from stripping this text out?](#license)\n\n\u003cbr /\u003e\n\n\u003cbr /\u003e\n\n\nWhat is the Closure Compiler? Why should I use it?\n:\n The Closure Compiler is a tool for making JavaScript download and\n run faster. You can use the Closure Compiler to reduce the size of\n your JavaScript files and to make them more efficient.\n\n\nHow is the Closure Compiler different from the other JavaScript\ncompressors that are out there?\n\n: Generally, the Closure Compiler should meet or exceed the compression\n of other code minification tools, and improve download times for your\n web application. In addition, the Closure Compiler can help you\n find syntax errors during development (rather than during testing)\n and identify potentially buggy code patterns.\n\n In Simple mode, Closure Compiler should be able to do better than\n other tools because it uses compiler-like analysis to find additional\n ways to minimize code size. For example, the Closure Compiler can\n inline functions that are used in only a few occurrences, reuse\n variable names, and pre-compute constant expressions.\n\n In Advanced mode, Closure Compiler can also use your added type\n annotations to find hard-to-spot bugs.\n\n\nCan the Closure Compiler compile JavaScript that's embedded in HTML?\n:\n No. The Closure Compiler works only on files that contain only JavaScript.\n\n\nCan I use the Closure Compiler together with other JavaScript\nminifiers?\n\n: Yes. Closure Compiler reads in any valid JavaScript and generates\n valid JavaScript, so you can apply the Closure Compiler to a\n JavaScript file either before or after you run the file through a\n different minifier.\n\n Remember that Closure Compiler and other minifiers might have\n expectations about the incoming code. A minifier that strips\n comments may remove licenses or annotation information needed by\n another tool, for example.\n\n\nHow can I debug the JavaScript that the Closure Compiler produces?\n:\n If your compiled code is throwing errors or exhibiting unexpected behavior,\n you can use Source Maps to debug the issue. A source map provides a mapping\n between the compiled code and the original source code so that the browser's\n developer tools can show you your original source code instead of the compiled code.\n To make the Closure Compiler produce a source map, pass the\n `--create_source_map` flag on the command line. For example: \n\n ```\n $ java -jar compiler.jar --js example.js --create_source_map ./example-map --js_output_file example-compiled.js\n ```\n\n Then, if you're using a browser that supports Source Maps (such as Chrome\n or Firefox), you can set breakpoints just as you would for uncompiled code,\n and the browser's developer tools will show the corresponding line of code\n in the original source. For more information about Chrome's developer tools, including\n information about source maps, see\n [Debugging JavaScript](https://developers.google.com/chrome-developer-tools/docs/javascript-debugging).\n\n\nDoes the compiler make any trade-off between my application's\nexecution speed and download code size?\n:\n Yes. Any optimizing compiler makes trade-offs. Some size\n optimizations do introduce small speed overheads. However, the\n Closure Compiler's developers have been careful not to introduce\n significant additional runtime. Some of the compiler's\n optimizations even decrease runtime (see next question).\n\n\nDoes the compiler optimize for speed?\n:\n In most cases smaller code is faster code, since download time is usually the most important speed factor in web applications. Optimizations that\n reduce redundancies speed up the run time of code as well.\n\n\nAre there any restrictions on the size of the files that can be compiled?\n:\n The compilation web service has a maximum file size, but the\n standalone compiler application does not.\n\n\nIs the Closure Compiler avalable for all platforms?\n:\n The compiler is written in Java, so it can run anywhere Java runs.\n\n\nCan the Compiler process any legal JavaScript?\n:\n Mostly. Some JavaScript constructs, including `eval()`\n and `with()`, can invalidate assumptions on which the\n compiler's transformations are based.\n\n\nHow much do I need to know about web development to use the\nClosure Compiler?\n:\n The Closure Compiler is a tool for JavaScript development, so you\n do need to know how to program in JavaScript to use the\n compiler. But anyone who uses JavaScript can benefit from using\n the Closure Compiler.\n\n\nHow does the Closure Compiler work with the Closure Library?\n:\n The Closure Compiler provides special checks and optimizations for\n code that uses the Closure Library. In addition, the Closure\n Compiler service can automatically include Closure Library\n files. [Finding\n Your Way around Closure](/closure/library/docs/introduction#deps) describes the syntax for declaring the\n parts of Closure that you need. See\n the [API\n reference](/closure/compiler/docs/api-ref#closure) for information on using the Closure Library with the\n API. To use the Closure Library with the Closure Compiler\n application you must\n first [download\n the Closure Library](https://github.com/google/closure-library). Support for the Closure Library is\n enabled in the compiler application by default.\n\n\nMy code stops working or the Compiler produces errors when I\ncompile with `ADVANCED_OPTIMIZATIONS`. Why?\n:\n Using Advanced mode usually requires some preparation and code\n changes. [Advanced Compilation\n and Externs](/closure/compiler/docs/api-tutorial3) explains how to make sure your code works\n with `ADVANCED_OPTIMIZATIONS`.\n\n\nWhy are there random line feeds in compiled scripts?\n:\n The Closure Compiler intentionally adds line breaks every 500\n characters or so. Firewalls and proxies sometimes corrupt or\n ignore large JavaScript files with very long lines. Adding line\n breaks every 500 characters prevents this problem. Removing the\n line breaks has no effect on a script's semantics. The impact on code size is small, and the Compiler\n optimizes line break placement so that the code size penalty is even smaller when files are gzipped.\n\n\nI have copyright notices or open source\nlicense text that must appear in my source code. How do I keep the\nClosure Compiler from stripping this text out?\n:\n Closure Compiler supports the JSDoc `@license` tag. Add the\n `@license` tag to any JSDoc comment to preserve the\n comment in the compiler\n output. See [Annotating\n JavaScript for the Closure Compiler](/closure/compiler/docs/js-for-compiler#tag-license) for more information."]]
