Вы устали тратить часы на отладку беспорядочного и трудночитаемого кода? Хотите повысить производительность и масштабируемость своих проектов? Что ж, тебе повезло! В этой статье мы составили список из 10 основных советов по написанию чистого и эффективного кода. Эти советы, от использования правильных отступов и пробелов до сведения к минимуму использования глобальных переменных, помогут вам написать код, который легко читать, понимать и поддерживать. Являетесь ли вы новичком или опытным разработчиком, эти советы помогут вам стать лучшим разработчиком. Итак, если вы готовы вывести свои навыки программирования на новый уровень, продолжайте читать и откройте для себя секреты написания чистого и эффективного кода!

  1. Используйте правильный отступ и пробелы. Правильные отступы облегчают чтение и понимание кода, а пробелы помогают разделять разные разделы и элементы.
#Bad Code Format:
def calculate_average_temperature(temperature_readings):
    total_temperature=0
    for reading in temperature_readings:total_temperature+=reading
    return total_temperature/len(temperature_readings)

#Good Code Format:
def calculate_average_temperature(temperature_readings):
    total_temperature = 0
    for reading in temperature_readings:
        total_temperature += reading
    return total_temperature / len(temperature_readings)

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

//Bad Code
def a(b):
    c=0
    for d in b:
        c+=d
    return c/len(b)
    
//Good Code
def calculate_average_temperature(temperature_readings):
    total_temperature = 0
    for reading in temperature_readings:
        total_temperature += reading
    return total_temperature / len(temperature_readings)

3. Прокомментируйте свой код. Комментарии — отличный способ объяснить, что делает код и как он работает, особенно для сложных или запутанных участков кода.

#Bad Code Format:
def a(b):c=0;for d in b:c+=d;return c/len(b)

#Good Code Format:
#This function calculates the average temperature from a list of temperature readings
def calculate_average_temperature(temperature_readings):
    #initialize a variable to store the total temperature
    total_temperature = 0
    #iterate through the list of temperature readings
    for reading in temperature_readings:
        #add the current reading to the total temperature
        total_temperature += reading
    #return the average temperature by dividing the total temperature by the number of readings
    return total_temperature / len(temperature_readings)

4. Минимизируйте использование глобальных переменных. Глобальные переменные могут вызывать конфликты и затруднять понимание и сопровождение кода. Копировать код

#Bad Code Format:
x = 0
def increment():
    global x
    x += 1
    return x

#Good Code Format:
def increment(x):
    x += 1
    return x

5. Используйте последовательное форматирование. Последовательный стиль форматирования облегчает чтение и понимание кода.

#Bad Code Format:
def calculate_average_temperature(temperature_readings):
 total_temperature = 0
 for reading in temperature_readings:
  total_temperature += reading
 return total_temperature/len(temperature_readings)

#Good Code Format:
def calculate_average_temperature(temperature_readings):
    total_temperature = 0
    for reading in temperature_readings:
        total_temperature += reading
    return total_temperature / len(temperature_readings)

6. Избегайте использования магических чисел. Магические числа — это жестко закодированные значения, которые не имеют значения или контекста. Вместо этого используйте константы или переменные, чтобы придать им значение.

Формат плохого кода не использует согласованный стиль форматирования, что затрудняет чтение и понимание кода. Хороший формат кода использует согласованный стиль форматирования, что облегчает чтение и понимание кода. Сюда входят отступы, пробелы и разрывы строк, которые помогают упорядочить код и сделать его более читабельным.

7. Делайте функции короткими и целенаправленными. Длинные функции могут быть трудными для чтения и понимания. Рекомендуется, чтобы ваши функции были короткими и были сосредоточены на одной задаче.

#Bad Code Format:
def calculate_average_temperature(temperature_readings):
    total_temperature = 0
    for reading in temperature_readings:
        total_temperature += reading
    average_temp = total_temperature / len(temperature_readings)
    
    # additional functionality 
    if average_temp > 25:
        print("It's hot!")
    elif average_temp < 10:
        print("It's cold!")
    else:
        print("It's just right.")
    return average_temp

#Good Code Format:
def calculate_average_temperature(temperature_readings):
    total_temperature = 0
    for reading in temperature_readings:
        total_temperature += reading
    return total_temperature / len(temperature_readings)

def check_temperature(average_temp):
    if average_temp > 25:
        print("It's hot!")
    elif average_temp < 10:
        print("It's cold!")
    else:
        print("It's just right.")

8. Избегайте использования слишком большого количества вложенных циклов или операторов if. Вложение слишком большого количества циклов или операторов if может затруднить чтение и понимание кода. Вместо этого попробуйте использовать более элегантное решение, такое как функция или библиотека.

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

// Without a library
let data = JSON.parse(response);

// With a library
let data = axios.get(url).then(response => response.data);

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

Я надеюсь, что эти 10 советов по написанию чистого и эффективного кода были вам полезны. Помните, написание чистого кода — это непрерывный процесс, который требует постоянного внимания и практики. Следуя этим советам, вы будете на пути к созданию кода, который легко читать, понимать и поддерживать. Имейте в виду, что всегда есть возможности для улучшения, поэтому не бойтесь экспериментировать и пробовать новое. Не забудьте подписаться на мою статью и следить за мной, чтобы в будущем получать больше подобного контента. Удачного кодирования!