Найкращі практики

Переглядай перед комітом

Завжди переглядай зміни перед тим, як закомітити їх: це підтримує якість коду й допомагає уникнути помилок.

Використовуй git diff і git status, щоб переглянути підготовлені та непідготовлені зміни перед комітом. Це допомагає впіймати помилки, залишки налагодження та випадкові зміни.

Погано
git add .
# Наосліп додано випадкові зміни
# до наступного коміту.
git commit -m "Fixed login bug"
git push

Коміт без перегляду змін.

Добре
git add .
# Переглянь зміни перед комітом.
git diff --staged
git commit -m "Fixed login bug"
git push

АБО

# Додай в область підготовки тільки потрібний файл.
git add src/login.js
# І все одно переглянь перед комітом.
git diff --staged
git commit -m "Fixed login bug"
git push

Переглядай зміни перед комітом, щоб випадкові правки не потрапили в репозиторій.

Що зазвичай проскакує без перегляду

Залишки налагодження — рядки console.log, тимчасові змінні/функції тощо.

Закоментований код, виконані TODO.

Зміни, що не стосуються наступного коміту. Часто трапляється, коли працюєш над кількома функціями одночасно.

Тимчасові API-ключі та інші секрети, яким не місце в репозиторії. Такі файли краще додати в .gitignore.

Загальні проблеми з якістю коду — синтаксичні помилки, одруки чи негаразди з форматуванням. Перегляд коду перед комітом допомагає їх упіймати: переглядаючи diff, ти зосереджуєшся саме на зроблених змінах, а не на всьому файлі.

Корисні команди для перегляду

Подивитися, які файли змінилися:

git status

Переглянути непідготовлені зміни:

git diff

Переглянути підготовлені зміни:

git diff --staged

Переглянути зміни в конкретному файлі:

git diff src/auth.js

Показати детальні зміни з контекстом:

git diff --word-diff

Перегляд у редакторі на базі VS Code

Якщо ти користуєшся VS Code, Cursor, Antigravity IDE чи іншим редактором на базі VS Code, переглядати незакомічені зміни через GUI дуже просто. Відкрий панель Source Control — і побачиш файли, змінені в робочому дереві.

Ой, я забув прибрати TODO-коментар до зробленої зміни.

Ой, я забув прибрати TODO-коментар до зміни, яку зробив.