Названия в коде: почему это не мелочь

Названия в коде: почему это не мелочь

Спор о названиях кажется вкусовщиной ровно до момента, когда вы возвращаетесь в свой код через полгода.

Что действительно важно. Название должно говорить, что это, а не как устроено: список активных клиентов, а не массив номер два. Функция называется по действию и результату: посчитать скидку, а не обработать. Логическое значение — утверждением, чтобы условие читалось как фраза.

Чего избегать. Сокращений, понятных только автору. Слов-пустышек: данные, информация, менеджер, обработчик — они не несут смысла. Названий, которые врут: функция называется «получить», а внутри меняет состояние — это ловушка для следующего читателя.

Отдельно про язык. Держитесь единообразия: смесь русской транслитерации и английского в одном проекте усложняет поиск и чтение.

Практический приём: если название придумывается с трудом, обычно сущность делает слишком много. Трудность с именованием — хороший сигнал, что пора разделить.

И честно: время, потраченное на удачное название, окупается при первом же возвращении к коду.

IT Воронеж — t.me/voronezh_it