JLLeitschuh/ktlint-gradle

Что это?

Ключевые возможности

• 01Добавляет задачи ktlintCheck и ktlintFormat для всех source set и скриптов Kotlin.
• 02Поддерживает проекты с плагинами kotlin, kotlin-android, kotlin-multiplatform и Kotlin JS.
• 03Позволяет использовать baseline-файл, чтобы игнорировать уже имеющиеся нарушения правил.
• 04Поддерживает собственные репортёры и наборы правил ktlint.
• 05Может устанавливать Git pre-commit hooks для проверки или форматирования файлов, добавленных в индекс.

Сценарии использования

• Поддержание единого стиля кода Kotlin в сборках Gradle для Android или JVM.
• Добавление линтинга в мультиплатформенный проект Kotlin без ручного изменения логики сборки.
• Постепенное внедрение линтинга в устаревшую кодовую базу с помощью baseline.
• Запуск проверок стиля в CI с помощью задачи ktlintCheck.

Быстрый старт

1. 1

   Добавьте плагин в блок plugins скрипта сборки (укажите текущую версию).

2. 2

   Добавьте mavenCentral() в repositories, чтобы можно было загрузить KtLint.

3. 3

   Запустите задачи Gradle ktlint в проекте.

Что важно знать

• !Плагин активируется только в проектах, где применяется поддерживаемый плагин Kotlin.
• !Требуются Gradle 7.4 или новее и Kotlin 1.4 или новее.

Темы

Частые вопросы

Что такое ktlint-gradle?

Плагин Gradle, который подключает ktlint и добавляет задачи проверки и автоформатирования Kotlin-проектов. ktlint-gradle — это плагин Gradle, который подключает линтер и форматтер ktlint для Kotlin и добавляет готовые задачи в сборку Gradle. С их помощью можно проверять и исправлять стиль кода без ручной настройки. Плагин активируется только в проектах с подключённым Kotlin-плагином и работает именно с кодом на Kotlin, а не с произвольными файлами.

ktlint-gradle можно использовать бесплатно? Какая у него лицензия?

ktlint-gradle распространяется с открытым исходным кодом под лицензией MIT. Перед использованием в коммерческих продуктах проверьте условия лицензии.

ktlint-gradle всё ещё поддерживается?

Активно поддерживается. Последний коммит в ktlint-gradle — 6 нояб. 2026 г..

Для чего можно использовать ktlint-gradle?

Поддержание единого стиля кода Kotlin в сборках Gradle для Android или JVM. Добавление линтинга в мультиплатформенный проект Kotlin без ручного изменения логики сборки. Постепенное внедрение линтинга в устаревшую кодовую базу с помощью baseline. Запуск проверок стиля в CI с помощью задачи ktlintCheck.

Как установить ktlint-gradle?

Добавьте плагин в блок plugins скрипта сборки (укажите текущую версию). Добавьте mavenCentral() в repositories, чтобы можно было загрузить KtLint. Запустите задачи Gradle ktlint в проекте.

Где скачать ktlint-gradle?

Исходный код и инструкции по установке — на GitHub: https://github.com/JLLeitschuh/ktlint-gradle