10 основных соглашений об именах для чистого и поддерживаемого кода

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

  1. Регистр Camel.
    Регистр Camel — это популярное соглашение об именах, при котором несколько слов объединяются, и каждое слово начинается с заглавной буквы, за исключением первого слова. Он обычно используется для именования переменных и функций в таких языках, как Java и JavaScript.

Пример:

int numberOfStudents;
void calculateTotalMarks() {
    // Code goes here
}
  1. Регистр Pascal:
    Регистр Pascal аналогичен регистру Camel, но первая буква первого слова также пишется с заглавной буквы. Он часто используется для именования классов и интерфейсов.

Пример:

class CarRentalService {
    // Code goes here
}
  1. Змеиный регистр.
    Змеиный регистр — это соглашение об именах, при котором несколько слов разделяются подчеркиванием. Он обычно используется в таких языках, как Python, для именования переменных и функций.

Пример:

total_amount = 1000
def calculate_discounted_price():
    # Code goes here
  1. Регистр «кебаб».
    Регистр «кебаб» аналогичен регистру «змея», но вместо подчеркивания для разделения слов используются дефисы. Он часто используется в URL-адресах и именах файлов.

Пример:

file-name.txt
  1. Венгерская нотация:
    Венгерская нотация добавляет к именам переменных группу символов, обозначающих их тип данных. Хотя в последние годы он вышел из моды, его все еще можно найти в устаревших кодовых базах.

Пример:

int iNumberOfStudents;
string strName;
  1. Сокращения.
    Сокращения следует использовать с осторожностью и только тогда, когда они широко узнаваемы и хорошо известны в контексте кодовой базы. Обычно предпочтительнее использовать осмысленные и описательные имена.

Пример:

HTTPRequest request;
  1. Множественное и единственное число:
    При присвоении имен коллекциям или переменным, представляющим несколько объектов, использование имен во множественном числе может сделать код более читабельным и интуитивно понятным.

Пример:

users = []
  1. Константы.
    Константы должны называться прописными буквами, а слова разделяться подчеркиванием. Это соглашение ясно дает понять, что значение не следует изменять.

Пример:

final int MAX_ATTEMPTS = 5;
  1. Значительные имена.
    Имена должны быть описательными и передавать назначение или назначение элемента кода. Избегайте использования общих имен, таких как «temp» или «data», которые не несут никакой значимой информации.

Пример:

function calculateTotalPrice(products) {
    // Code goes here
}
  1. Избегайте двусмысленности.
    Имена должны быть однозначными и не приводить к путанице или неверному толкованию. Избегайте использования похожих названий или сокращений, которые могут вызвать путаницу.

Пример:

int startDate;
int endDate;

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