Соглашение о стилистике кода

Данная страница содержит описание текущего стиля написания кода на языке Kotlin.

Правила наименований

При возникновении сомнений по умолчанию используется следующие правила Соглашение о стилистике кода для языка Java:

  • используйте camelCase в названиях (а также избегайте подчёркиваний)
  • названия типов пишутся с заглавной буквы
  • названия методов и свойств начинаются со строчной буквы
  • используйте отступ из 4 пробелов
  • функции, объявленные как public, желательно снабжать документацией в стиле документации языка Kotlin

Двоеточие

В тех случаях, когда двоеточие разделяет тип и подтип, перед двоеточием ставится пробел. Если же двоеточие ставится между сущностью и типом, то пробел опускается:

interface Foo<out T : Any> : Bar {
    fun foo(a: Int): T
}

Лямбда-выражения

В лямбда-выражениях фигурные скобки, а также стрелка и параметры отделяются пробелами. Желательно передавать лямбду за пределами скобок.

list.filter { it > 10 }.map { element -> element * 2 }

В коротких лямбда-выражениях, не являющихся вложенными, рекомендуется использовать соглашение it вместо явного объявления параметра. Во вложенных лямбдах с параметрами последние всегда должны быть объявлены.

Тип Unit

Если возвращаемым типом является Unit, то его можно явно не указывать:

fun foo() { // здесь пропущено ": Unit"

}