⚖️ Старый vs Новый: как писать аккуратнее

← К оглавлению урока

⚡ Главное

В уроке нет устаревшего API, но есть места, где новичок легко привыкает к неудачному стилю. Не пишите несколько инструкций через точку с запятой, не называйте переменные одной буквой без причины, не заменяйте понятный код комментариями. Для первого урока допустима конкатенация строк через +, но дальше появятся f-строки.

Несколько инструкций в одной строке

Как возможно в Python

# main.py
num1 = 5; num2 = 7

Как лучше писать сейчас

# main.py
num1 = 5
num2 = 7

Вариант с точкой с запятой технически работает, но хуже читается. Для учебного и рабочего кода пишите одну инструкцию на строку.

Имена переменных

Слабый стиль

# main.py
n = "Alice"
a = "25"
c = "Paris"

Более понятный стиль

# main.py
user_name = "Alice"
user_age = "25"
user_city = "Paris"

Короткие имена допустимы в простых формулах или циклах, но в обычной программе имя должно помогать понять смысл данных.

Комментарии

Комментарий повторяет код

# main.py
# Выводим имя
print(name)

Комментарий объясняет причину

# main.py
# input() возвращает строку, поэтому возраст пока выводим без вычислений.
print(age)

Хороший комментарий объясняет не «что написано», а «почему так сделано».

Склейка строк

Базовый вариант из первого урока

# main.py
name = input("Введите имя: ")
print("Hello, " + name)

Современный вариант, который изучим позже

# main.py
name = input("Введите имя: ")
print(f"Hello, {name}")
⚠️ Проверить по документации: f-строки — современный и удобный способ форматирования, но в этом курсе они разбираются позже. На первом уроке достаточно понимать конкатенацию и вывод через запятую.