Плохой код — кривая программа и потрёпанные нервы разработчиков, которые занимаются её обслуживанием и обновлением. Как написать хороший код, который не стыдно передать в работу коллегам? 7 практических рекомендаций в статье.
Посмотри на свой код со стороны и подумай, как было бы удобнее воспринимать его, если бы ты впервые его увидел? Скорее всего, у тебя бы не получилось быстро найти нужный кусок в огромном полотне кода. Поэтому первый совет — разбей его на блоки или модули. Конечно, здесь важна логика, например, один блок описывает одно действие.
У всех классов, функций, переменных есть имена. Твоя задача — написать такие имена, которые будут отвечать на вопросы: «зачем этот элемент?», «какие функции он выполняет?», «как он используется?». При этом не забывать о разумной длине имён.
Добавляй пояснения к элементам, кода, на которые нужно обратить особое внимание и которые нельзя менять. Не рассчитывай, что коллега сам разберётся. Он может пропустить это, и вы потратите время на исправление. Тут главное не перестараться и не захламить код ненужными комментариями. Как правильно писать комментарии к коду, мы рассказывали здесь, в статье есть примеры для разных языков.
С каким кодом тебе самому было бы приятно работать: с аккуратным, читаемым, понятным или с нагромождением мешанины? Чтобы сделать всё красиво и понятно для коллег, рекомендуем использовать правила форматирования, которые приняты в твоей компании или на конкретном проекте.
Проведи код через анализатор, чтобы выявить скрытые ошибки и проблемы. Попробуй такие инструменты, как Checkstyle, PMD, FindBugs или SonarQube. Они помогут обнаружить ошибочную реализацию требований или структуры кода. Эти инструменты встраиваемые, их можно использовать для автоматической проверки.
Библиотеки существуют, чтобы облегчить работу программистов. Не нужно изобретать велосипед и тратить время на разработку функций, которые уже прописаны в библиотеках. Главное здесь не увлечься библиотеками: для одного кода лучше использовать одну библиотеку. И не забудь проверить актуальность библиотеки. Если тебя интересуют JavaScript-фреймворки, прочитай эту статью, в ней мы собрали список лучших.
Отдай код на ревью коллегам, но не тимлиду или постановщику задачи, здесь важен свежий взгляд. Если в команде такой возможности нет, договорись с другом, делайте ревью кода друг для друга. Так ты сможешь получать обратную связь по своей работе и прокачивать навыки, изучая чужой код.
Хочешь научиться писать качественный код и гарантированно устроиться на работу? Поступай в Kata Academy: выбирай язык (Java, Go, JavaScript) и оставляй заявку. Обучение не требует вложений, оплата только после трудоустройства по специальности. Программа ориентирована на практику, создание портфолио и устройство на работу. В каждом курсе есть сопровождение менторов и HR-консультантов. Узнай подробности на сайте Kata Academy.
Читать еще:
Работа без опыта в IT
Ты только что закончил обучение и готов начать свою карьеру? Но есть проблема: у тебя нет опыта работы. Необязательно иметь костюм супергероя, чтобы быть им. Давай вместе разберёмся, какие навыки и качества нужно развивать, чтобы привлечь внимание работодателей! Ведь главное — верить в себя и не бояться экспериментировать!
Что выбрать: Java или JavaScript?
Выбор между Java и JavaScript — всё равно что выбор между латте и капучино. Вроде бы оба напитка — кофе, но какой из них лучше? Давай разберёмся!
5 задач на логику от HR-менеджеров для разработчиков и других IT-специалистов
Мы собрали пять популярных задач на логику и добавили в них свои детали, чтобы было интереснее решать. Такие упражнения можно использовать для подготовки к собеседованиям или для тренировки мышления.
Что такое функциональное чтение? Или как эффективно учиться программированию
Функциональное чтение позволяет эффективнее работать с новой информацией. Как этот метод поможет читать книги для программистов и не только? Разбираем в сегодняшней статье.