Ошибки Git: что значат сообщения fatal и error и как их исправить
Когда Git не может выполнить команду, он пишет строку, которая начинается с fatal: или error:. Найдите её текст в таблицах ниже и откройте разбор — там написано, что значит сообщение и какие команды ввести. Здесь же — как читать остальные строки ответа.
Содержание 10
Что сделать прямо сейчас
- Найдите в ответе Git строку, которая начинается с
fatal:илиerror:. - Найдите похожий текст в таблицах ниже и откройте разбор.
- Если похожего текста нет — посмотрите, что Git думает о папке, командой
git status, и сверьтесь с таблицами ещё раз.
Команды Git вводятся там, где лежит репозиторий: на сервере — после подключения по SSH (как подключиться), на своём компьютере — в Терминале (Mac) или в Git Bash (Windows).
Как читать ответ Git
| Начало строки | Что значит |
|---|---|
fatal: | Git остановился, команда не выполнена |
error: | ошибка; после неё Git может остановиться строкой fatal: |
warning: | предупреждение: Git продолжил работу |
hint: | подсказка — что можно сделать; на ошибку не указывает |
| без пометки | ход работы, например Cloning into … или Auto-merging … |
Строки перед fatal: бывают не от Git. Например, Permission denied (publickey) пишет SSH — программа, через которую Git связывается с сервисом, где лежит репозиторий. Такие строки тоже ищите в таблицах: они подсказывают причину.
Git пишет сообщения по-английски, если в системе не включён перевод. На своём компьютере Git может отвечать по-русски — смысл сообщений тот же. Чтобы увидеть английский текст и найти его в таблицах, повторите команду с LC_ALL=C в начале, например LC_ALL=C git pull — так работает в Терминале Mac, в Git Bash и на сервере.
Папка и права
| Сообщение | Что значит |
|---|---|
| fatal: not a git repository | в этой папке и выше по пути нет репозитория Git |
| fatal: detected dubious ownership in repository | папка принадлежит другому пользователю, и Git ей не доверяет |
| fatal: could not create work tree dir '…': Permission denied | git clone не может создать папку: нет прав |
| fatal: destination path '…' already exists | папка для git clone уже есть и в ней лежат файлы |
| fatal: Unable to create '…/index.lock': File exists | Git запущен в этой папке или прошлая команда не убрала замок |
| error: insufficient permission for adding an object | в папке .git есть файлы другого пользователя |
Обновление кода: git pull
| Сообщение | Что значит |
|---|---|
| Your local changes to the following files would be overwritten | файлы на сервере правили вручную, и обновление их перезаписало бы |
| fatal: Need to specify how to reconcile divergent branches | и у вас, и в репозитории есть свои новые коммиты |
| fatal: refusing to merge unrelated histories | у двух репозиториев нет общего начала |
| CONFLICT (content): Merge conflict in … | одни и те же строки изменены и у вас, и в репозитории |
| Your branch is behind 'origin/main' | в репозитории есть коммиты, которых у вас ещё нет |
| error: cannot pull with rebase: You have unstaged changes | git pull в режиме rebase не начнёт, пока в папке есть правки |
Коммиты и отправка: git commit и git push
| Сообщение | Что значит |
|---|---|
| Author identity unknown | не заданы имя и почта для коммитов |
| ! [rejected] … (fetch first) | в репозитории есть коммиты, которых нет у вас; сначала заберите их |
| nothing to commit, working tree clean | git commit не видит изменений |
| .gitignore не работает | Git видит файл, который указан в .gitignore |
| warning: … LF will be replaced by CRLF | предупреждение: Git поменяет концы строк в файле |
Связь с репозиторием
| Сообщение | Что значит |
|---|---|
| fatal: Could not read from remote repository | Git не смог получить доступ к репозиторию по SSH: нет ключа, неверный адрес или нет доступа |
| Permission denied (publickey) | сервис, где лежит репозиторий, не принял SSH-ключ |
| Host key verification failed | SSH не смог проверить, что подключается к нужному сервису |
| error: remote origin already exists | адрес с именем origin уже записан |
| fatal: 'origin' does not appear to be a git repository | в настройках нет адреса с именем origin |
Ветки
| Сообщение | Что значит |
|---|---|
| You are in 'detached HEAD' state | вы не на ветке, а на отдельном коммите |
| error: pathspec '…' did not match any file(s) known to git | Git не нашёл ветку или файл с таким именем |
| fatal: a branch named '…' already exists | ветка с таким именем уже есть |
Откуда тексты
Сообщения на этой странице и в разборах сверены с исходным кодом Git 2.43.0 — эта версия ставится из пакетов Ubuntu 24.04. В других версиях тексты могут немного отличаться, смысл тот же. Версию Git покажет команда git --version.
Источники
- Пакет git в Ubuntu 24.04 — версия 2.43.0, с ней сверены тексты сообщений.
- Исходный код Git 2.43.0: usage.c — начало строк fatal:, error: и warning:.
- Исходный код Git 2.43.0: advice.c — строки с подсказками hint:, тексты о неразрешённых конфликтах и Not possible to fast-forward.
- Исходный код Git 2.43.0: setup.c — тексты not a git repository, detected dubious ownership и подсказка про safe.directory.
- Исходный код Git 2.43.0: builtin/clone.c — тексты could not create work tree dir и destination path … already exists, клонирование в пустую папку.
Сверено 20 октября 2026 года.
Что почитать дальше
- Как установить Git на Ubuntuустановка, имя и почта, git clone и git pull.
- Все ошибки SSHесли Git не может подключиться к репозиторию.
- Права на файлы сайта на VPSвладелец и права папки сайта.
- Команды Gitвсе команды для папки сайта на одной странице.