Git с нуля: первые команды и безопасный первый коммит

За 20–30 минут вы установите Git 2.45 или новее, создадите локальный репозиторий, добавите файл и сделаете первый коммит. Этого достаточно, чтобы начать работать с историей проекта и не потерять изменения до подключения GitHub или GitLab.

Что нужно подготовить

Установите Git с официального сайта и откройте терминал. В Windows подойдёт Git Bash, в macOS — Terminal, в Linux — любой эмулятор терминала. Проверьте версию:

git --version

В ответе должна появиться строка с версией Git, например git version 2.45.2. Номер может отличаться: основные команды ниже одинаковы для Git 2.45 и более новых выпусков.

До начала вам также понадобятся:

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

Git не отправляет файлы в интернет сам по себе. Локальный репозиторий хранит историю на вашем компьютере; удалённый сервер подключается отдельным шагом.

Первые команды: от папки до коммита

1. Настройте имя и электронную почту

Git записывает автора в каждый коммит. Эти параметры задаются один раз для текущего пользователя компьютера:

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

Если рабочий компьютер общий и настройки должны действовать только в одном проекте, уберите --global. Проверить результат можно так:

git config --global --list

Проверка: в выводе есть user.name, user.email и, если вы добавляли последнюю строку, init.defaultbranch=main.

2. Создайте папку проекта и включите Git

Перейдите в каталог, где хранятся проекты, создайте учебную папку и войдите в неё. Команды ниже подходят для macOS, Linux и Git Bash:

mkdir git-first-project
cd git-first-project
git init

git init создаёт скрытую папку .git. В ней Git хранит служебные данные и историю, поэтому удалять её вручную не нужно.

Проверка: терминал сообщает, что создан пустой репозиторий, а команда ниже показывает текущую ветку и состояние:

git status

В выводе должна быть ветка main или другое имя, которое использует ваша установка Git. Если видите сообщение о пустом репозитории, всё прошло правильно.

3. Создайте первый файл

Откройте папку git-first-project в редакторе и создайте файл README.md с таким содержимым:

# Мой первый проект Git

Это учебный репозиторий.

Сохраните файл в корне проекта, рядом со скрытой папкой .git. Проверить, что Git видит новый файл, можно командой:

git status

Проверка: файл указан в разделе Untracked files или «Непрослеживаемые файлы». Это не ошибка: Git пока только обнаружил файл, но ещё не включил его в следующий коммит.

4. Добавьте файл в индекс

Индекс — промежуточный список изменений, которые попадут в ближайший коммит. Добавьте конкретный файл:

git add README.md

Добавление всего проекта командой git add . удобно, но опасно для новичка: вместе с кодом можно случайно включить архив, файл настроек или секрет. Начните с явного имени файла.

Проверка: снова выполните git status. Файл должен появиться в разделе Changes to be committed и быть отмечен как новый.

5. Создайте коммит

Коммит сохраняет подготовленные изменения в истории. Сообщение должно описывать действие, а не состояние вроде «изменения»:

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

Флаг -m передаёт короткое сообщение коммита. Не добавляйте в него пароли, токены и содержимое конфигурационных файлов.

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

6. Посмотрите сохранённую историю

Для короткого списка коммитов используйте:

git log --oneline

В первой строке будет короткий идентификатор коммита и текст Добавить README проекта. Полная информация доступна через git log, но для первых проверок компактный вариант удобнее.

Проверка: в истории есть ровно один коммит с вашим именем автора и указанным сообщением.

7. Измените файл и сравните версии

Добавьте в README.md новую строку, например Следующий шаг — изучить ветки., но пока не выполняйте git add. Посмотрите изменения:

git diff

Эта команда сравнивает рабочий файл с последним коммитом. Затем сохраните второе изменение:

git add README.md
git commit -m "Обновить описание проекта"
git log --oneline

Проверка: в истории две строки, а git status снова сообщает о чистом рабочем дереве.

Коммит — не кнопка «сохранить вообще». Это именованная точка в истории, к которой можно вернуться и с которой можно сравнивать дальнейшие изменения.

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

Если команда не сработала

«git: command not found» или «git is not recognized»

Git не установлен или его каталог не добавлен в системную переменную PATH. Установите Git заново с официального сайта, перезапустите терминал и повторите git --version. В Windows проверьте, что запускаете Git Bash либо терминал после установки.

«Author identity unknown»

Git не получил имя и электронную почту. Выполните команды настройки из первого шага без угловых скобок, затем повторите коммит:

git config --global user.name "Ваше имя"
git config --global user.email "you@example.com"
git commit -m "Добавить README проекта"

«fatal: not a git repository»

Команда запущена не в папке репозитория. Выполните pwd в macOS/Linux или Get-Location в PowerShell, затем перейдите в каталог проекта через cd. Если репозиторий ещё не создан, запустите git init только в нужной папке.

Коммит сообщает «nothing to commit»

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

Файл не появляется в git status

Проверьте имя и путь. Возможно, файл попал под правило в .gitignore или вы находитесь не в том каталоге. Для диагностики сначала выполните git status --short и сравните текущую папку с расположением файла.

Что важно не делать в первом проекте

• Не выполняйте git add ., пока не посмотрели вывод git status.
• Не храните в репозитории пароли, приватные ключи, токены, резервные копии баз данных и локальные файлы с секретами.
• Не называйте каждый коммит «фикс» или «обновление»: через неделю такое сообщение не объяснит, что именно изменилось.
• Не удаляйте папку .git, если не хотите полностью стереть локальную историю этого проекта.

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

Создайте файл .gitignore под язык и редактор проекта, затем изучите ветки и подключение удалённого репозитория. Перед каждой отправкой изменений на сервер проверяйте git status, git diff и содержимое коммита через git show --stat. В рабочем проекте полезно отдельно контролировать, не попали ли в историю секреты и сгенерированные файлы.