Читаемость кода — это не просто прихоть, а залог продуктивности. Чем понятнее код, тем проще его поддерживать и меньше багов он содержит. Сегодня я расскажу несколько простых, но мощных техник, которые помогут сделать код чище.
1. Используйте говорящие имена переменных и функций
❌ Плохо:
def f(a, b):
return a + b
✅ Хорошо:
def calculate_total_price(price: float, tax: float) -> float:
return price + tax
Название должно передавать суть, а не заставлять читателя гадать.
2. Разбивайте код на функции
Код должен быть модульным. Если в функции больше 20 строк — подумайте, можно ли её разбить.
❌ Плохо (монолитная функция):
def process_order(order):
tax = order.price * 0.2
total = order.price + tax
print(f"Total price: {total}")
order.status = "processed"
save_to_db(order)
✅ Хорошо (логично разнесённый код):
def calculate_tax(price):
return price * 0.2
def process_payment(order):
tax = calculate_tax(order.price)
total = order.price + tax
print(f"Total price: {total}")
return total
def finalize_order(order):
order.status = "processed"
save_to_db(order)
3. Избегайте "магических чисел"
Числа в коде без пояснений — зло. Лучше использовать именованные константы.
❌ Плохо:
discounted_price = price * 0.9
✅ Хорошо:
DISCOUNT_RATE = 0.1
discounted_price = price * (1 - DISCOUNT_RATE)
4. Следуйте PEP 8
Форматирование кода важно! Используйте линтеры, например
black или flake8, чтобы соблюдать стандарт.5. Документируйте код
Хороший код объясняет сам себя, но комментарии тоже нужны.
❌ Плохо:
# Умножаем x на 2
x = x * 2
✅ Хорошо:
# Удваиваем сумму для учёта бонусов
final_amount = amount * 2
Подписывайтесь на канал 👉@pythonofff