Коротко о главном
Git нужен разработчикам, администраторам и авторам документации. Он позволяет фиксировать изменения, возвращаться к рабочим версиям и объединять работу нескольких людей. В статье пройдём путь от первой настройки до веток, удалённого репозитория и безопасной отмены изменений. Примеры используют стандартные команды, доступные в Debian, Fedora и Arch.
История коммитов помогает понять, когда и зачем появилось изменение. Ветки позволяют разрабатывать функции изолированно и проверять их перед слиянием. Распределённая модель даёт полноценную копию истории на каждой машине. Git также становится основой для code review и автоматизации выпусков.
Большинство проблем с git сводится к нескольким повторяющимся ошибкам. Ниже — что проверить в первую очередь и как не усугубить ситуацию.
Почему это происходит
Ошибки почти всегда связаны с контекстом: другая версия пакета, не тот пользователь, устаревший конфиг или команда из руководства для другой системы. git не исключение. Поэтому сначала фиксируем исходное состояние, затем меняем одну вещь за раз.
Типичные ошибки
Ниже — сбои, которые встречаются чаще всего. Перед исправлением сохраните текущие конфиги и запишите, какие изменения вносите: так проще откатиться.
1. Git просит указать user.email и user.name.
Выполните git config —global user.name и user.email с корректными значениями. Проверьте результат через git config —global —list.
2. Push отклонён с сообщением non-fast-forward.
Сначала выполните git pull, разберитесь с изменениями и повторите push. Не используйте force без понимания последствий для общей ветки.
3. После merge появились конфликты.
Откройте файлы с маркерами, оставьте нужный вариант, выполните git add и завершите слияние через git commit. Для отказа используйте git merge —abort.
4. Терминал сообщает detached HEAD.
Вы находитесь на коммите, а не на ветке. Создайте ветку через git switch -c имя или вернитесь на нужную ветку через git switch main.
Как настроить правильно
Правильная последовательность проста: проверить версию и зависимости, сделать резервную копию конфигурации, внести минимальное изменение, проверить логи и только потом двигаться дальше.
Установка
В Debian, Ubuntu и Linux Mint используется пакетный менеджер APT:
sudo apt install git
В Fedora и RHEL-совместимых системах пакет ставится через DNF:
sudo dnf install git
В Arch Linux и производных пакет доступен в официальных репозиториях:
sudo pacman -S git
1. Укажите автора и ветку по умолчанию
Git записывает имя и почту в каждый коммит, поэтому настройте их до начала работы. Команда init.defaultBranch задаёт имя основной ветки для новых репозиториев. Параметры сохраняются в ~/.gitconfig.
git config --global user.name 'Иван Иванов'
git config --global user.email 'ivan@example.com'
git config --global init.defaultBranch main
2. Создайте репозиторий и первый коммит
git init создаёт служебный каталог .git в текущей папке. Файл нужно добавить в индекс командой git add, а затем зафиксировать. Сообщение коммита должно кратко описывать изменение.
mkdir demo && cd demo
git init
printf 'hello\n' > README.md
git add README.md
git commit -m 'Первый коммит'
3. Создайте ветку и выполните слияние
Ветка изолирует новую работу от основной линии. После коммита в feature её можно влить в main. Если изменения затрагивают одни и те же строки, Git попросит разрешить конфликт.
git switch -c feature/login
git add .
git commit -m 'Добавлена форма входа'
git switch main
git merge feature/login
4. Подключите удалённый репозиторий
Remote задаёт адрес общей копии, а push отправляет локальные коммиты. Флаг -u связывает локальную ветку с удалённой. Замените URL на адрес своего репозитория.
git remote add origin https://example.com/user/demo.git
git push -u origin main
Рабочий конфиг
Начните с минимального рабочего варианта. Не копируйте большой конфиг целиком: добавляйте параметры по одному и проверяйте результат после каждого изменения.
# ~/.gitconfig
[user]
name = Иван Иванов
email = ivan@example.com
[init]
defaultBranch = main
[core]
editor = vim
[pull]
rebase = false
[alias]
st = status -sb
lg = log --oneline --graph --decorate --all
Практические советы
Эти рекомендации проверены на повседневных задачах. Начните с тех, которые закрывают вашу текущую боль, а не со всего списка сразу.
Совет 1. Создайте .gitignore до первого коммита и добавьте туда сборочные артеф
Создайте .gitignore до первого коммита и добавьте туда сборочные артефакты, секреты и зависимости.
Совет 2. Используйте git switch -c для новой ветки и git switch для переключени
Используйте git switch -c для новой ветки и git switch для переключения: эти команды понятнее старого checkout.
Совет 3. Проверяйте git diff —staged перед коммитом, чтобы не отправить лишние
Проверяйте git diff —staged перед коммитом, чтобы не отправить лишние файлы.
Совет 4. git commit —amend исправляет только последний коммит; не применяйте е
git commit —amend исправляет только последний коммит; не применяйте его к уже опубликованной общей истории без согласования.
Профилактика
Большинство повторяющихся сбоев с git связано не с ошибкой в самой программе, а с окружением: обновились зависимости, изменился путь, закончилось место или другой администратор поправил конфиг. Поэтому профилактика начинается с фиксации исходного состояния.
Сохраните рабочий конфиг в систему контроля версий, добавьте короткий комментарий о том, зачем нужен каждый нестандартный параметр, и запишите команду проверки. Через месяц вы скажете себе спасибо: восстановить логику по чужому файлу без пояснений почти невозможно.
Чек-лист
- Версия пакета и конфигурация зафиксированы и доступны для сравнения.
- Есть автоматическая проверка синтаксиса перед перезапуском службы.
- Журналы ротуются, а диск не заполняется ими за неделю.
- Изменения проходят через тестовый стенд, а не сразу на рабочий сервер.
Итог
Большинство ошибок с git лечится не переустановкой, а проверкой конфигурации, логов и прав доступа. Действуйте по одному изменению за раз — и причина быстро найдётся.