LETUNOFF DOCS

GitHub. Работа с коммитами

🧱 Суть

Коммит (commit) – это сохранение текущего состояния проекта в истории Git.
Перед созданием коммита изменения необходимо добавить в индекс (staging area).

Типичный порядок действий:

Изменения → git status → git add → git commit

📦 Основные команды

Проверить изменения

Показать текущее состояние репозитория:

git status

Команда отображает:

  • изменённые файлы;
  • новые файлы;
  • удалённые файлы;
  • какие изменения уже подготовлены к коммиту.

Добавить изменения

Добавить все изменения:

git add .

Добавить конкретный файл:

git add src/components/Button.tsx

Создать коммит

git commit -m "feat: add login form"

После создания коммита изменения сохраняются в локальной истории Git.

git add и Staging Area

Команда git add не создаёт коммит.
Она переносит изменения в индекс (staging area) – область подготовки перед коммитом.

Ментальная модель:

Рабочая папка
       │
       ▼
git add
       │
       ▼
Staging Area
       │
       ▼
git commit
       │
       ▼
История Git

💻 git add ., git add -u и git add -A

git add .

Добавляет:

  • новые файлы;
  • изменённые файлы.
git add .

Используется чаще всего.

git add -u

Добавляет:

  • изменённые файлы;
  • удалённые файлы.

Не добавляет новые файлы.

git add -u

git add -A

Добавляет абсолютно всё:

  • новые файлы;
  • изменённые файлы;
  • удалённые файлы;
  • переименованные файлы.
git add -A

Особенно полезен после массовых переименований или перемещения файлов.

Хорошие сообщения коммитов

Наиболее распространённый формат – Conventional Commits.

<type>: <описание>

Основные типы:

ТипНазначение
featНовый функционал
fixИсправление ошибки
refactorРефакторинг
docsДокументация
styleФорматирование
testТесты
choreКонфигурация, зависимости

Примеры

Хорошие сообщения:

feat: add weather card
fix: handle empty response
refactor: extract api layer
docs: update README

Плохие сообщения:

fix
update
asdf
minor changes

Рекомендации

Хороший коммит:

  • описывает одно логическое изменение;
  • написан кратко;
  • использует настоящее время;
  • не содержит лишних слов.

🎯 Вывод

  • git status показывает состояние репозитория;
  • git add подготавливает изменения к коммиту;
  • git commit сохраняет изменения в истории Git;
  • хорошие сообщения коммитов делают историю проекта понятной и удобной для навигации.

🔗 Связано

Обратные ссылки