Имя переменной — часть объяснения кода
Переменная хранит значение, которое программа использует или меняет. Её имя помогает понять, что именно хранится, не прослеживая каждый шаг вычислений. Например, `x` ничего не говорит о содержимом, а `userAge` подсказывает, что это возраст пользователя. Но если значение на самом деле обозначает число дней с момента регистрации, такое имя уже вводит в заблуждение.
Поэтому удачное имя должно передавать не только тип данных, но и роль значения в конкретном месте программы. `price` может означать исходную цену, цену со скидкой или стоимость одной единицы — и для каждого случая читателю кода нужна разная подсказка.
Почему нельзя просто назвать всё подробнее
Слишком короткое имя оставляет важный смысл за пределами кода. Слишком длинное приходится снова и снова читать и набирать; к тому же оно может создать ложное впечатление, будто переменная хранит больше, чем на самом деле. Разработчик ищет формулировку, которая снимает вероятную путаницу, не превращая каждую строку в пояснение.
Решение зависит от окружения. Внутри короткого цикла `i` часто достаточно понятно: роль переменной видна рядом. А название вроде `currentCustomerSubscriptionRenewalDate` может быть полезным, если без него трудно отличить дату продления от даты начала подписки. Важны также привычки команды: одинаковые понятия лучше называть одинаково, чтобы читателю не приходилось угадывать, скрываются ли за разными словами разные вещи.
Цена имени проявляется позже
Имя особенно важно, когда код меняют не те, кто его написал. Точное название помогает быстрее увидеть, какое значение можно безопасно использовать и что может сломаться при изменении. Поэтому подбор иногда занимает непропорционально много времени: несколько удачных слов способны сэкономить повторные разъяснения при каждом чтении и правке кода.
