#Что означает ошибка
index.lock
Ошибка fatal: Unable to create '.git/index.lock': File exists означает, что Git считает, что другая операция уже идёт, и не хочет менять индекс одновременно. Файл блокировки остаётся после аварийно завершённой команды, закрытия IDE во время операции или работы двух программ.
Прежде чем удалять файл, убедитесь, что Git действительно не запущен.
Удаление работающей блокировки может повредить индекс.
Предыдущий процесс git завершился аварийно и оставил lock-файл. Убедитесь, что git не запущен, и удалите index.lock.
#Причины и решения
| Возможная причина | Как узнать | Что делать |
|---|---|---|
| Аварийный выход | Прежняя операция Git аварийно завершилась, а работающих процессов больше нет | Только после проверки процессов удалите конкретный осиротевший index.lock. |
| Работает другой git | В редакторе или терминале ещё выполняется индексирующая операция Git | Дождитесь завершения; не удаляйте блокировку работающего процесса. |
| Нет прав | Сообщение об отказе записи в .git при сохранении блокировки | Проверьте владельца и разрешения папки; не меняйте права рекурсивно вслепую. |
| Синхронизация | Проект находится в синхронизируемой папке и блокировка повторяется | Предпочтите отдельную локальную копию и синхронизацию изменений через Git. |
#Пошаговое решение
- Закройте программы, использующие GitВ каталоге проекта закройте редактор, который мог выполнять Git (например, VS Code, GitHub Desktop), и дождитесь завершения текущих команд
commit,rebase,merge,checkout,fetch. Если в терминале выполняется Git, не удаляйте блокировку: дождитесь завершения или выясните причину зависания. Откройте новый терминал именно в корне этого репозитория и выполнитеgit rev-parse --show-toplevel, чтобы убедиться, что находитесь в нужном проекте. - Проверьте отсутствие процессов gitВ Windows нажмите Ctrl+Shift+Esc → «Диспетчер задач» → «Подробности» и найдите
git.exe; также проверьте, не работает ли операция в среде разработки. В Linux/macOS выполните в терминалеps -ef | grep "[g]it"и сверьте процесс с вашим проектом. Наличие Git требует ожидания; процесс может также находиться под именем редактора/оболочки. Не используйтеkill -9без определения процесса и понимания последствий незавершённой записи. - Удалите .git/index.lockТолько если уверены, что никаких операций Git больше нет и сообщение указывает **ровно на
.git/index.lock**, проверьте наличие файла: Linux/macOS —ls -l .git/index.lock, Windows PowerShell —Test-Path .git\index.lock. Если файл есть, сделайте резервную копию его имени/времени и удалите этот один файл:rm .git/index.lockлибоRemove-Item .git\index.lockв PowerShell. Выполняйте из корня репозитория, не используйтеrm -rf .gitили рекурсивное удаление блокировок. В рабочих деревьяхgit worktreeкаталог.gitможет быть файлом: остановитесь и уточните реальный путь черезgit rev-parse --git-path index.lock. - Запустите git statusЗатем выполните
git statusиgit diff --stat. Если Git показывает текущую ветку и список изменений вместо ошибкиindex.lock, блокировка снята. Если вывод содержитYou have unmerged paths,rebase in progressили повреждённый индекс, **не удаляйте.git/indexи не запускайтеreset --hard**: сначала разберитесь, не нужно ли завершить/отменить прерванную операцию.git fsckможно использовать для дополнительной проверки объектов, но он не исправляет автоматически конфликт индекса. - Исключите .git из синхронизации и антивирусаЕсли блокировка повторяется, проверьте, не открыты ли два клиента Git для одной папки и не синхронизируется ли рабочий каталог службой OneDrive/Dropbox. Для репозитория, синхронизируемого облаком, предпочтительно перенести его в обычную локальную папку с сохранением резервной копии и затем настроить синхронизацию через Git-remote. Не отключайте антивирусное сканирование целиком: при подозрении на влияние защиты сообщите администратору и уточните безопасное исключение для конкретного проекта.
#Если не помогло
Удаляйте index.lock только если уверены, что никакой процесс git не работает.
#Проверка процессов
Закройте IDE, клиенты Git (GitHub Desktop, GitKraken, TortoiseGit) и терминалы с запущенным git. Проверьте процессы: Windows — диспетчер задач, процессы git.exe; Linux/macOS — ps aux | grep git. Дождитесь окончания долгих операций (gc, fetch). Если процессов нет — блокировка осиротевшая.
#Удаление блокировки
Удалите файл: Linux/macOS — rm -f .git/index.lock; Windows PowerShell — Remove-Item .git\index.lock -Force; cmd — del .git\index.lock. Затем выполните git status. Для блокировок других файлов (.git/refs/heads/main.lock, .git/HEAD.lock, shallow.lock) принцип тот же: найдите файл из текста ошибки и удалите после проверки процессов.
#Если повторяется
Причина может быть в антивирусе или облачной синхронизации (OneDrive, Dropbox), которая блокирует папку .git: исключите репозиторий из облачной синхронизации; настройки антивируса согласуйте с администратором. Проверьте целостность: git fsck. Если индекс повреждён (index file corrupt), сначала сделайте резервную копию всего репозитория и обратитесь к документации по восстановлению индекса: удаление .git/index и git reset без проверки может потерять состояние индекса, особенно частично подготовленные изменения. Проверьте, что вы не запускаете git в нескольких терминалах параллельно скриптом.
# Только в корне обычного Git-репозитория и ПОСЛЕ проверки отсутствия Git-процессовgit rev-parse --git-path index.lockgit status# В отдельном действии при точно подтверждённом осиротевшем файле:# Linux/macOS: rm .git/index.lock# Windows PowerShell: Remove-Item .git\index.lockКоманда может изменить состояние системы или её настройки. Проверьте параметры и последствия перед запуском.