code-patterns

Паттерны и качество кода

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

15 юнитов·50 уроков·~16 ч

Начать трек →

Что такое хороший код

Код читают и меняют намного чаще, чем пишут, поэтому главная стоимость ПО — стоимость изменения. «Хороший код» — не эстетика, а код, чьё следующее изменение дёшево. Этот юнит ставит эту призму.

01 Стоимость изменения 18 мин 02 Триада сопровождаемости 20 мин 03 Чисто, а не хитро 18 мин

Имена и намерение

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

01 Именование — это акт проектирования 18 мин 02 Раскрывающие намерение имена 18 мин 03 Согласованность и область видимости 18 мин

Функции и связность

Функция должна делать одно дело на одном уровне абстракции, разделять команды и запросы и держать аргументы и побочные эффекты немногочисленными и явными. Цель — связность; малый размер — следствие.

01 Маленькие функции, одно дело 19 мин 02 Единый уровень абстракции 19 мин 03 Разделение команд и запросов 19 мин 04 Аргументы и побочные эффекты 19 мин

Комментарии и контракты

Комментарии гниют, потому что не исполняются; предпочитай самодокументируемый код и выноси инварианты в типы и тесты, которые не врут. Немногие стоящие комментарии объясняют зачем, а не что.

01 Когда комментарии врут 18 мин 02 Самодокументируемый код 19 мин 03 Типы и тесты как документация 20 мин

SRP: единая ответственность

У модуля должна быть одна причина для изменения — он отвечает одному актору, — а не буквально делать одно дело. Группируй код по тому, кто требует изменений; и божественный класс, и взрыв классов — провалы SRP.

01 Одна причина для изменения 19 мин 02 Акторы и оси изменения 19 мин 03 Дробить, не раскалывая 19 мин

Открытость/закрытость и Лисков

Добавляй поведение, добавляя код, а не правя протестированный (OCP) — но лишь вдоль предсказуемой оси изменений. Подтипы обязаны соблюдать контракт супертипа, чтобы подстановка не удивляла вызывающего (LSP).

01 Открыт для расширения, закрыт для модификации 19 мин 02 Полиморфизм вместо условий 19 мин 03 Подстановка Лисков 19 мин 04 Проектирование и соблюдение контрактов 20 мин

ISP и инверсия зависимостей

Держи интерфейсы узкими, чтобы клиент не зависел от ненужных методов (ISP), и пусть высокоуровневая политика зависит от абстракций, которыми владеет, а не от низкоуровневых деталей (DIP). Порты, адаптеры и DI — механика.

01 Разделение интерфейса 19 мин 02 Инверсия зависимостей 20 мин 03 Порты и адаптеры 20 мин 04 Внедрение зависимостей в TypeScript 20 мин

Связанность и связность вглубь

У связанности есть измеримая таксономия (connascence): рефактори в сторону более слабой и локальной связи. Закон Деметры и границы модулей по фичам запирают радиус поражения изменений.

01 Коннасенс 20 мин 02 Закон Деметры 19 мин 03 Проведение границ модулей 20 мин

Запахи: раздуватели

Запахи-раздуватели — длинные методы, большие классы, одержимость примитивами, группы данных — это распад связности, лечимый извлечением и объектами-значениями. Расходящееся изменение и разрозненная правка — запахи SRP, читаемые по истории git.

01 Длинный метод, большой класс 19 мин 02 Одержимость примитивами и группы данных 19 мин 03 Расходящееся изменение и стрельба дробью 20 мин

Запахи: связки и лишнее

Запахи связок и лишнего — зависть к функциям, цепочки сообщений, посредники, мёртвый код, спекулятивная общность, переключатели по типу — связывают или раздувают код. Перемещай поведение к его данным, удаляй неиспользуемое и заменяй растущие switch полиморфизмом.

01 Завистливые функции и неуместная близость 20 мин 02 Цепочки сообщений и посредник 20 мин 03 Мёртвый код и спекулятивная общность 18 мин 04 switch по типу и отвергнутое наследство 19 мин

Рефакторинг: страховочная сеть

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

01 Характеризующие тесты 20 мин 02 Швы 19 мин 03 Базовые приёмы под зелёным 19 мин

Рефакторинг: крупные ходы

Крупные рефакторинги — извлечь класс, заменить условие полиморфизмом, ввести объект-параметр — перестраивают дизайн под зелёными тестами; паттерны — это пункты назначения, к которым рефакторят по требованию кода, а не шаблоны, навязанные заранее.

01 Выделение класса 20 мин 02 Замена условного оператора полиморфизмом 20 мин 03 Введение объекта-параметра 19 мин 04 Рефакторинг к паттернам 20 мин

Эвристики и компромиссы

DRY, KISS и YAGNI — конфликтующие эвристики, и суждение состоит в выборе, какая важнее. Правило трёх сопротивляется преждевременной абстракции, ведь дублирование намного дешевле неправильной абстракции.

01 DRY, KISS, YAGNI в противоречии 20 мин 02 Правило трёх 19 мин 03 Неправильная абстракция 19 мин

Антипаттерны и технический долг

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

01 Божественный объект и анемичная доменная модель 20 мин 02 Квадрант технического долга 19 мин 03 Legacy-код и правило бойскаута 20 мин

Капстоун: рефакторинг запутанного модуля

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

01 Капстоун I: инвентаризация запахов 20 мин 02 Капстоун II: инкрементальный рефакторинг 21 мин 03 Капстоун III: измеряем до и после 20 мин

Следующий трек

Паттерны React

Ты уже умеешь писать на React — теперь освой паттерны уровня senior: композицию, архитектуру состояния, границу сервер/клиент, Suspense и антипаттерны, от которых нужно избавляться, чтобы компоненты оставались простыми по мере роста.