Автоматичне форматування при коміті: Husky та lint-staged

Як автоматичне форматування рятує код-рев’ю

Кожен другий PR у JavaScript/TypeScript-проєктах містить суперечки про стиль коду — відступи, лапки, крапки з комою. Розробники витрачають до 20% часу код-рев’ю лише на обговорення форматування. Це не лише сповільнює поставку, а й демотивує команду. Ми впроваджуємо автоматичний фікс при кожному коміті через Husky та lint-staged, і проблема зникає. В одному проєкті на React + TypeScript з командою з 5 осіб час рев’ю скоротився з 40 хвилин до 15, а кількість конфліктів злиття знизилась на 30%. Типова помилка — налаштовувати форматування локально, але забувати інтегрувати в CI. Це призводить до того, що код у репозиторії не відповідає стандартам. Ми одразу включаємо перевірки в CI/CD, щоб гарантувати єдиний стиль на всіх етапах. Середня економія часу команди з 5 осіб — 8 людино-годин на тиждень. Замовте налаштування та позбавтесь рутини. Отримайте безкоштовну оцінку вашого проєкту протягом дня.

Чому автоматичне форматування при коміті необхідне?

Без автоматизації кожен розробник використовує свої налаштування форматування. В результаті код у різних гілках відрізняється, а merge request’и перетворюються на обговорення відступів. Автоматичний фікс при коміті вирішує цю проблему на корені: код завжди приводиться до єдиного стандарту перед записом у репозиторій. Це знижує когнітивне навантаження на рев’юверів і прискорює інтеграцію змін.

Як налаштувати Prettier та ESLint за 30 хвилин?

Для JavaScript/TypeScript-проєктів стандарт — зв’язка Prettier (форматування) та ESLint (якість коду). Встановлення:

npm install --save-dev prettier eslint

Створіть файли конфігурації .prettierrc та .eslintrc.js. Для автоматичного запуску при коміті використовуйте Husky та lint-staged:

npm install --save-dev husky lint-staged
npx husky init

У package.json додайте:

{
  "lint-staged": {
    "*.{js,ts,jsx,tsx}": ["eslint --fix", "prettier --write"],
    "*.{css,scss,md,json,yaml}": ["prettier --write"]
  }
}

Офіційна документація Husky рекомендує також додати хук commit-msg для перевірки повідомлень комітів.

Чому lint-staged кращий за повну перевірку проєкту?

lint-staged обробляє лише staged (індексовані) файли. Це критично для швидкості: при коміті не перевіряється весь проєкт, а лише змінені файли. Повна перевірка може займати хвилини, lint-staged — секунди. У великому монорепозиторії з 500+ файлами повний прогін ESLint триває 3–4 хвилини, а lint-staged — менше 5 секунд. Ми наполегливо рекомендуємо цей підхід.

Порівняння форматувальників для різних мов

Універсальне рішення — pre-commit framework

Для Python-проєктів або змішаних репозиторіїв використовуйте pre-commit. Приклад конфігу:

# .pre-commit-config.yaml
repos:
  - repo: https://github.com/pre-commit/pre-commit-hooks
    rev: v4.6.0
    hooks:
      - id: trailing-whitespace
      - id: end-of-file-fixer
      - id: check-yaml
  - repo: https://github.com/psf/black
    rev: 24.4.2
    hooks:
      - id: black
  - repo: https://github.com/astral-sh/ruff-pre-commit
    rev: v0.4.0
    hooks:
      - id: ruff
        args: [--fix]

Встановіть хуки: pip install pre-commit та pre-commit install. Підтримується понад 1000 готових хуків для будь-яких мов.

Інтеграція з CI: покрокова інструкція

Щоб гарантувати дотримання стандартів навіть при обході локальних хуків, додайте перевірки в CI.

1. Створіть файл .github/workflows/lint.yml (для GitHub Actions).
2. Додайте крок встановлення залежностей: npm ci або pip install -r requirements.txt.
3. Додайте кроки запуску форматування та лінтингу: npx prettier --check . та npx eslint ..
4. Для Python: black --check . та ruff check ..
5. Запуште зміни в репозиторій — тепер кожен PR буде перевірятися автоматично.

Це займає 1–2 години налаштування і повністю виключає можливість потрапляння невідформатованого коду в master.

Як гарантувати дотримання стандартів, незважаючи на обхід локальних хуків?

Локальні хуки можна обійти флагом --no-verify. Єдиний надійний спосіб — перевірки в CI. Налаштування CI-пайплайну займає годину і дає стовідсоткову гарантію, що код у master відповідає стандартам. Після впровадження CI в одному проєкті кількість обходів скоротилася з 40% до нуля. Замовте послугу — ми налаштуємо CI за 1–2 години.

Порівняння часу налаштування для різних стеків

Що входить у роботу та строки

При замовленні налаштування автоматичного форматування ми надаємо:

• Налаштування Husky, lint-staged, Prettier, ESLint під ваш стек
• Конфігурацію pre-commit для Python/PHP/Go проєктів
• Інтеграцію перевірок у GitHub Actions або GitLab CI
• Документацію для команди (як додати нову мову)
• Підтримку протягом місяця після налаштування

Строки: налаштування для однієї мови — 2–4 години, інтеграція з CI — 1–2 години. Ми автоматизували складання та деплой у 50+ проєктах, і в кожному випадку виключили суперечки про стиль коду. В одному Python-проєкті на Django впровадження pre-commit та CI зайняло 3 години, після чого жоден коміт з порушенням стилю не потрапив у master. Замовте налаштування автоматичного форматування — ваша команда перестане витрачати час на обговорення відступів. Отримайте безкоштовну консультацію та оцінку вашого проєкту протягом дня.

Послуги бекенд-розробки: production-grade надійність

На production-сервері о 3:14 ночі черга Laravel Jobs перестала оброблятися — 40 000 необроблених завдань у Redis. Причина: worker упав через memory leak у статичній змінній Eloquent observer, supervisor не перезапустив через misconfigured stopwaitsecs. Ми розбирали такий інцидент на проекті з 500 RPS: діагностика 4 години, фікс — 20 хвилин. Щоб ви не втрачали гроші, пропонуємо послуги бекенд-розробки з акцентом на production-grade надійність — 10+ років досвіду, 50+ проектів, 5 років на ринку. Оцінимо ваш проект за 2 дні.

Які проблеми вирішуємо

N+1 запити: головний вбивця швидкості

N+1 — найпоширеніша причина повільних сторінок у Laravel-додатках. Стандартна історія: сторінка працювала нормально на dev з 10 записами, на production з 10 000 — 8-секундне завантаження.

Laravel Debugbar у dev-оточенні показує кількість запитів. Більше 20 — сигнал для audit.

Model::preventLazyLoading(! app()->isProduction());

Telescope для профілювання: логує всі запити, jobs, mail, notifications з деталізацією. Після впровадження eager loading час завантаження сторінки падає з 8 с до 0.3 с — у 27 разів.

Memory leak у статичних змінних

У Laravel Octane або Swoole додаток тримається в пам’яті між запитами. Статичні змінні не скидаються — призводять до неконтрольованого росту пам’яті. Використовуємо defer-функції та контейнерні біндинги для коректного скидання стану.

Неправильний connection pool

Rails, Laravel, Django відкривають нове з'єднання PostgreSQL на кожен PHP/Python процес. 100 воркерів — 100 з'єднань. PostgreSQL деградує від 200+ активних з'єднань через overhead на управління.

PgBouncer у transaction pooling: 1000 воркерів → 20–50 реальних з'єднань. Це знижує latency на 40% та зменшує витрати на хостинг на 30% — при середній вартості хостингу $2,000/міс економить $600/міс. GIN-індекс для JSONB до 100 разів швидший за B-tree при пошуку.

Як Octane справляється з високим навантаженням?

Laravel Octane (RoadRunner або Swoole) прибирає overhead bootstrap на кожен HTTP-запит. Приріст: 3–8x на синтетичних бенчмарках, 2–4x на реальних додатках. Важливо: не зберігати стан у статичних змінних — застосовуємо це на проектах >1000 RPS.

Як PostgreSQL допомагає уникнути повільних запитів?

Використовуємо composite indexes для WHERE + ORDER BY, partial indexes для фільтрів з високою селективністю, GIN-індекси для JSONB та full-text search. to_tsvector + GIN замість LIKE '%query%' — запобігає seq scan навіть на мільйонах записів. Аналізуємо плани через EXPLAIN ANALYZE та pg_stat_statements.

Як обрати стек для вашого проекту?

Node.js виправданий для realtime: Laravel публікує події в Redis Pub/Sub, Node.js підписується та транслює клієнтам. Go — для goroutines (10k з'єднань на сервер — норма), але розробка повільніша, ніж Laravel.

Чому Redis критичний для продуктивності?

Redis виконує кілька ролей:

Redis Cluster для горизонтального масштабування, Sentinel для автоматичного failover. Замовте консультацію щодо оптимізації Redis для вашого проекту.

Що входить в роботу під ключ

• Архітектурне проектування (документація API, схема БД, діаграма сервісів)
• Реалізація за узгодженим ТЗ з code review
• Налаштування CI/CD (GitHub Actions, Docker), моніторингу (Sentry, Grafana), алертингу
• Навантажувальне тестування (k6, wrk) зі звітом
• Передача вихідних кодів, доступів, інструкція з деплою
• Навчання команди замовника (2–3 сесії)
• Гарантійна підтримка 1 місяць після здачі

Орієнтири по термінах

Вартість розраховується індивідуально після аналізу вимог до навантаження, інтеграцій та бізнес-логіки. Зв'яжіться з нами для безкоштовного аудиту вашого поточного backend — отримайте план оптимізації за 2 дні. Замовте консультацію та дізнайтеся, як знизити витрати на інфраструктуру на 30% без втрати продуктивності.