Как называть переменные

Имя переменной — это маленькая документация. Хорошее имя объясняет смысл без комментариев.

Имя должно отражать смысл

Называйте переменную по тому, что она хранит: «user_age», «total», «is_ready». Избегайте «a», «x», «tmp» — кроме совсем коротких, очевидных случаев вроде счётчика в цикле.

Хорошее имя избавляет от необходимости комментария.

Стиль snake_case

В Python переменные и функции принято писать строчными буквами со знаком подчёркивания: «max_speed», «read_file». Классы — с большой буквы (CamelCase).

Константы пишут заглавными: «PI = 3.14159».

Длина имени

Имя должно быть достаточно длинным, чтобы быть понятным, и достаточно коротким, чтобы читаться. «n» плохо, «number_of_students_in_the_class» — чересчур; «students_count» в самый раз.

Для коротких локальных переменных допустимы короткие имена, для важных — подробные.

Частые ошибки

Не называйте переменные как встроенные функции (list, str, sum) — это их «перекрывает». Не используйте кириллицу и пробелы.

Не давайте вводящие в заблуждение имена: если в «users» лежит одно имя, а не список, это запутает читателя.

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

Можно ли называть переменные по-русски? Технически можно, но принято по-английски — так код понятнее большему числу людей.

Как быстро научиться? Практикой: пишите маленькие программы и перечитывайте их через день. Удобно начать в игровом тренажёре «Дрон Кодер».