Ошибка «gradle не является внутренней или внешней командой, исполняемой программой или пакетным файлом» появляется в командной строке Windows, когда система не может найти исполняемый файл gradle.bat по путям, перечисленным в переменной окружения Path. Проще говоря, Windows не знает, где установлен Gradle, и поэтому не может выполнить команду.
Проблема возникает как сразу после установки Gradle, так и внезапно — например, после обновления системы, переустановки JDK или смены каталога с инструментами сборки. Ниже разберём, как проверить установку, правильно настроить переменные окружения и что делать, если настройки на месте, а ошибка сохраняется.
Почему Windows не находит команду gradle
Когда вы вводите команду в cmd или PowerShell, система ищет исполняемый файл в текущем каталоге, а затем во всех папках, указанных в переменной Path. Если каталог bin внутри папки Gradle там отсутствует, выдаётся именно эта ошибка. Тот же механизм работает и для java, javac и других консольных утилит.
Типичные причины, из-за которых Gradle «теряется»:
- 🔧 Gradle не установлен вообще — проверялся только проект с Gradle Wrapper, а сам дистрибутив на компьютере отсутствует.
- 📁 Папка
binдистрибутива не добавлена в переменную окружения Path или путь указан с ошибкой. - ✏️ Путь добавлен, но окно командной строки было открыто до изменения переменных — старые окна не видят новые настройки.
- 📦 Архив с Gradle распакован не полностью, и файла
gradle.batв каталогеbinнет. - 🔄 Gradle был удалён или перемещён, а в Path осталась ссылка на несуществующий каталог.
⚠️ Внимание: изменения переменных окружения действуют только на новые окна командной строки. Уже открытые консоли, а также запущенные IDE (например, IntelliJ IDEA или Android Studio) могут требовать перезапуска, чтобы подхватить обновлённый Path.
Шаг 1. Проверка, установлен ли Gradle
Прежде чем настраивать переменные, убедитесь, что дистрибутив действительно есть на диске. Если вы скачивали архив с официального сайта, найдите папку, куда он был распакован — внутри должна быть структура вида gradle-x.x\bin\gradle.bat. Именно файл gradle.bat отвечает за запуск в Windows.
Быстрая проверка из командной строки — попробуйте запустить Gradle по полному пути, подставив свой каталог:
"C:\Gradle\gradle-8.5\bin\gradle.bat" --versionЕсли команда отработала и показала версию — Gradle установлен, и проблема только в переменной Path. Если система сообщает, что файл не найден, дистрибутив отсутствует или лежит в другом месте. Тогда скачайте архив binary-only с официального сайта Gradle и распакуйте его в каталог без кириллицы и пробелов в пути — это исключит лишние проблемы с экранированием.
Шаг 2. Настройка переменных окружения JAVA_HOME и Path
Gradle требует установленный JDK (не путать с JRE). Проверьте, что переменная JAVA_HOME указывает на каталог установки JDK, а java -version выполняется без ошибок. Если команда java тоже «не является командой», сначала настройте Java, иначе Gradle всё равно не запустится.
Порядок настройки в Windows 10 и 11:
- ⚙️ Откройте
Панель управления → Система → Дополнительные параметры системыили нажмитеWin + Rи введитеsysdm.cpl. - 🌍 Нажмите кнопку Переменные среды внизу окна.
- ➕ В разделе системных (или пользовательских) переменных найдите
Path, нажмите «Изменить» и добавьте путь к каталогуbinGradle, напримерC:\Gradle\gradle-8.5\bin. - 💾 Сохраните изменения кнопкой «ОК» во всех окнах и откройте новое окно командной строки.
Проверьте результат командой:
gradle --versionЕсли выводится информация о версии Gradle, JVM и ОС — настройка завершена. Некоторые инструкции дополнительно предлагают создать переменную GRADLE_HOME с путём к корню дистрибутива и добавить в Path значение %GRADLE_HOME%\bin — так удобнее обновлять версию, меняя одну переменную.
☑️ Проверка настройки Gradle
Шаг 3. Ошибка сохраняется: типичные причины
Иногда путь прописан, а ошибка никуда не девается. В таком случае проверьте содержимое переменной Path напрямую из консоли — команда echo %Path% покажет, какие каталоги система реально видит. Если вашего пути там нет, изменения не сохранились или были внесены не в ту переменную (пользовательскую вместо системной, или наоборот).
Ещё одна частая ситуация — опечатка в пути: лишний пробел, отсутствующий слеш или указание корня дистрибутива вместо подкаталога bin. В Path должен быть именно каталог bin, где лежит gradle.bat, а не корневая папка Gradle — это самая распространённая ошибка при ручной настройке.
⚠️ Внимание: если в Path одновременно присутствуют несколько разных версий Gradle, система возьмёт ту, что стоит выше в списке. Удалите или переместите вниз устаревшие записи, чтобы избежать путаницы с версиями в проектах.
Ниже сводка симптомов и действий:
| Симптом | Вероятная причина | Что делать |
|---|---|---|
| gradle не распознаётся нигде | Каталог bin не в Path | Добавить путь к bin в переменную Path |
| Работает по полному пути, но не по короткому | Опечатка или неверный уровень каталога в Path | Проверить echo %Path%, исправить запись |
| Gradle запускается, но падает с ошибкой Java | Не задан JAVA_HOME или стоит JRE | Установить JDK, прописать JAVA_HOME |
| Работало, перестало после обновления | Дистрибутив перемещён или удалён | Проверить существование каталога, обновить путь |
| В IDE ошибка, а в cmd всё работает | IDE запущена до изменения переменных | Перезапустить IDE или ПК |
Альтернатива: Gradle Wrapper вместо системной установки
Для работы с конкретным проектом устанавливать Gradle глобально вовсе не обязательно. Большинство проектов (включая Android-проекты) содержат Gradle Wrapper — скрипты gradlew и gradlew.bat в корне репозитория, которые сами скачивают нужную версию Gradle и запускают её.
Чтобы собрать такой проект, перейдите в его каталог и выполните:
gradlew.bat buildОбратите внимание: команда вызывается с указанием файла из текущего каталога, а не просто как gradle. Wrapper избавляет от настройки Path и гарантирует, что у всех участников команды используется одинаковая версия сборщика. Если проект открывается в Android Studio, среда обычно использует встроенный wrapper автоматически.
Как узнать, есть ли в проекте Gradle Wrapper
Откройте корень проекта и поищите файлы gradlew, gradlew.bat и папку gradle\wrapper с файлом gradle-wrapper.properties. Если они есть — глобальная установка Gradle не нужна, запускайте сборку через gradlew.bat.
Проверка результата и типичные вопросы
Итоговая проверка занимает меньше минуты: откройте новое окно cmd, выполните gradle --version и убедитесь, что выводится версия сборщика, версия JVM и путь к ней. Если вместо этого снова появляется сообщение об ошибке — вернитесь к проверке echo %Path% и убедитесь, что путь к bin присутствует и указан без опечаток.
Нужно ли перезагружать компьютер после изменения Path?
Обычно достаточно закрыть и заново открыть командную строку или IDE. Перезагрузка требуется редко — в основном если переменные изменялись, пока было запущено много приложений, которые унаследовали старое окружение.
Чем отличается gradle от gradlew?
gradle — глобально установленный сборщик, который требует настройки Path. gradlew — wrapper внутри проекта, который сам скачивает нужную версию Gradle и не требует системной установки.
Работает ли инструкция для PowerShell?
Да, переменная Path общая для cmd и PowerShell. Разница лишь в синтаксисе проверки: в PowerShell используйте $env:Path вместо echo %Path%. Само сообщение об ошибке в PowerShell формулируется иначе, но причина та же.
Можно ли ставить Gradle через менеджер пакетов?
Да, существуют установщики вроде Scoop или Chocolatey, которые сами прописывают пути. Это удобный вариант, если не хотите редактировать переменные вручную, но убедитесь, что менеджер пакетов сам установлен корректно.
Ошибка появляется только в Android Studio — что делать?
Проверьте в настройках среды, какой Gradle и JDK использует проект, и перезапустите IDE после изменения системных переменных. В большинстве случаев Android Studio работает через встроенный wrapper, и глобальная установка Gradle ей не требуется.