Коммиты в Git: первые шаги без лишней магии

За 10–15 минут вы создадите локальный Git-репозиторий, сохраните первый коммит и проверите его в истории. Это пригодится даже для небольшого сайта или папки с документами: Git поможет увидеть, что изменилось и к какому состоянию можно вернуться.

Что понадобится

Инструкция подходит для Git 2.x: команды ниже работают в актуальных версиях этой ветки. Установите Git и откройте терминал — например, Terminal на macOS или Linux, Git Bash либо PowerShell на Windows. Для первого коммита не нужны GitHub, GitLab и интернет.

Понадобится папка с проектом или пустая папка для упражнения. Команды выполняйте в терминале, а не по одной строке в адресной строке браузера. Если Git уже установлен, проверьте это командой:

git --version

В ответ появится версия, например git version 2.x.x. Это и есть проверка: если терминал сообщает, что команда не найдена, сначала установите Git с официального сайта.

Первый коммит: по шагам

1. Перейдите в папку проекта. Если папка называется my-project и лежит в текущей директории, выполните:

   cd my-project

   Проверка: приглашение терминала показывает путь к папке проекта. Если вы начинаете с нуля, сначала создайте папку привычным способом и перейдите в неё.

2. Настройте имя и электронную почту для коммитов. Git хранит эти данные в метаданных каждого коммита. Укажите своё имя и адрес, который вы хотите видеть в истории:

   git config --global user.name "Ваше имя"
   git config --global user.email "you@example.com"

   Проверка: выполните git config --global --list и найдите строки user.name и user.email. Параметр --global задаёт значения для ваших репозиториев на этом компьютере; настройки конкретного проекта могут их переопределить.

3. Создайте репозиторий. В папке проекта выполните:

   git init

   Проверка: Git сообщит, что создал пустой репозиторий. В папке появится скрытая служебная директория .git; удалять или редактировать её вручную не нужно.

4. Посмотрите, что Git видит.

   git status

   Проверка: команда показывает текущую ветку и файлы, которые ещё не отслеживаются. Если папка пустая, добавьте в неё обычный файл проекта — например, README.md — и снова выполните git status.

5. Подготовьте файл к коммиту. Например, чтобы добавить только README.md:

   git add README.md

   Чтобы подготовить все изменения в папке проекта, можно выполнить git add .. Но для первого опыта безопаснее указать конкретный файл: так проще заметить, если в папку случайно попали лишние данные. Проверка: после git status файл появится в разделе подготовленных изменений.

6. Сохраните коммит. Напишите короткое сообщение, которое объясняет изменение:

   git commit -m "Добавить описание проекта"

   Проверка: Git выведет сообщение о созданном коммите и его идентификатор. Если увидели ошибку про имя или почту, вернитесь к шагу 2 и проверьте настройки.

7. Проверьте историю и чистоту рабочей папки.

   git log --oneline
   git status

   Проверка: первая команда показывает новый коммит в истории, вторая сообщает, что рабочее дерево чистое. Теперь у проекта есть первая сохранённая точка, к которой можно обратиться в истории Git.

Что именно произошло

Git не сохраняет каждое изменение автоматически. Сначала вы выбираете файлы командой git add, затем фиксируете подготовленный снимок состояния командой git commit. Поэтому перед коммитом полезно запускать git status: эта команда показывает, что изменено и что попадёт в следующий снимок.

Коммит¹ — запись в истории репозитория, которая фиксирует подготовленные изменения и содержит автора, время и сообщение. Это не резервная копия компьютера: сам по себе коммит не отправляет файлы на другой сервер.

Коммит — не кнопка «сохранить всё». Вы сами выбираете, какие изменения войдут в историю.

Если не получилось

• git: command not found или «git не является внутренней или внешней командой». Git не установлен или терминал не видит его в системном пути. Установите Git, откройте новое окно терминала и повторите git --version.

• Author identity unknown. Git не знает, какое имя и адрес записать в коммит. Выполните команды настройки из шага 2. Для одного репозитория вместо --global можно задать имя и почту только в его настройках, находясь в этой папке.

• nothing to commit, working tree clean. Git не видит новых изменений, которые можно сохранить. Возможно, вы ещё не создали или не изменили файл, уже сделали коммит либо находитесь не в той папке. Проверьте путь и вывод git status.

• После git add файл всё ещё не попал в коммит. Уточните его имя и путь, затем снова проверьте git status. Файл может игнорироваться правилами из .gitignore; не удаляйте эти правила вслепую, сначала выясните, почему файл исключён.

• В коммит попал не тот файл. Если коммит ещё не создан, подготовьте нужные файлы заново и проверьте список в git status. Если коммит уже создан, не переписывайте историю наугад: для первого шага достаточно изучить содержимое коммита командой git show --stat и при необходимости сделать отдельный исправляющий коммит.

Что сделать дальше

Измените один файл, снова выполните git status, добавьте только этот файл и создайте второй коммит. Так вы увидите основной рабочий цикл: посмотреть изменения, выбрать нужное, зафиксировать результат. Следующий шаг — изучить ветки и удалённые репозитории; отправка истории на GitHub или другой сервер не нужна для работы с локальными коммитами.

¹ В Git коммит фиксирует снимок подготовленных файлов, а не просто отдельную строку изменений. Подготовленную область также называют индексом или staging area.