Константы в Kotlin: как правильно их создавать и использовать?

Правильный подход к константам в Kotlin

Вы совершенно правы: val внутри класса — это не константа времени компиляции, а просто неизменяемое свойство экземпляра. Для настоящих констант в Kotlin есть два основных подхода, и выбор зависит от типа данных.

1. Константы времени компиляции (compile-time constants) — модификатор const

Используйте const val, когда значение известно на этапе компиляции и является примитивным типом или строкой. Такие константы встраиваются прямо в байт-код и не имеют поля в классе.

• Где объявлять: на уровне файла (top-level) или внутри object (включая companion object).
• Типы: только String и примитивы (Int, Double, Boolean и т.д.).
• Именование: UPPER_SNAKE_CASE (как в Java).

// На уровне файла — самый простой и рекомендуемый способ
const val MAX_LOGIN_ATTEMPTS = 5
const val APP_NAME = "MyApp"

// Внутри объекта (например, companion object класса)
class LoginManager {
    companion object {
        const val MAX_ATTEMPTS = 5
        const val APP_NAME = "MyApp"
    }
}

2. Константы для сложных объектов — val в объекте

Если константа — это список, объект, enum или любое другое не-примитивное значение, const использовать нельзя. В этом случае объявляйте val внутри object (или на уровне файла, но обычно object даёт лучшую организацию).

object AppConfig {
    val SUPPORTED_LOCALES = listOf("en", "ru", "de")
    val DEFAULT_TIMEOUT = Duration.ofSeconds(30)
    val ERROR_CODES = mapOf(
        404 to "Not Found",
        500 to "Internal Server Error"
    )
}

Такой объект будет синглтоном, и его поля инициализируются лениво (при первом обращении), что безопасно для сложных структур.

3. Локальные константы внутри функции

Для значений, используемых только внутри одной функции, просто используйте val:

fun calculateDiscount(price: Double): Double {
    val MINIMUM_PRICE = 100.0  // локальная константа
    val DISCOUNT_RATE = 0.1    // локальная константа
    return if (price >= MINIMUM_PRICE) price * DISCOUNT_RATE else 0.0
}

Итоговые рекомендации (best practices):

• Для примитивов и строк — всегда используйте const val на уровне файла или в companion object. Это даёт максимальную производительность.
• Для сложных объектов — объявляйте val внутри object (или companion object).
• Именование — UPPER_SNAKE_CASE для констант (это общепринятый стиль в Kotlin, хотя в официальном style guide допускается и lowerCamelCase для констант, не являющихся частью публичного API).
• Не используйте val внутри класса для констант — это создаёт поле для каждого экземпляра, что неэффективно.
• Группируйте константы по смыслу: например, object NetworkConfig, object UiConstants — это улучшает читаемость кода.

Надеюсь, теперь стало понятнее. Главное правило: если значение можно вычислить на этапе компиляции и оно примитив — const. Если нет — val в объекте.

class LoginManager {
    companion object {
        const val MAX_ATTEMPTS = 5
        const val APP_NAME = "MyApp"
        val ERROR_CODES = setOf(401, 403)  // не примитив — без const
    }
}

// Использование:
val max = LoginManager.MAX_ATTEMPTS