​​Статья: Правила хорошего кода

Снайпер из Team Fortess 2 однажды сказал «У профессионалов есть стандарты». И если говорить про написание кода, то общие стандарты выглядят так:

— Соблюдайте единый Code-Style. По код-стайлу существует много разных правил, но главное — стиль должен быть единым. Например: одинаковый принцип именования, одинаковая расстановка скобок и отступов.

— Не используйте «магические числа». Это константы, которые прямо используются в виде аргументов метода, значение которых непонятно без комментария. Лучше выводить все значения в отдельные переменные и давать им понятное название.

— Используйте осмысленные имена для программных сущностей. Хороший признак — когда код не нуждается в комментариях — по названию классов и методов и так всё понятно.

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

— Отделяйте интерфейс от реализации. Это не только соблюдение правил инкапсуляции, но и просто про улучшение читабельности кода.

Ещё больше советов по хорошим практикам в коде можно найти в этой статье.

#статья #код #советы #ru