できない.dev

Git「Unable to create '.git/index.lock': File exists」の原因と直し方

Unable to create '.git/index.lock': File exists は、git のロックファイルが残っていると出る。
他の git が動いていないと確かめて .git/index.lock を消せば直る。

公開: 更新:

症状できない · exit 128
git add f.txt
fatal: Unable to create '/tmp/tmp.eoPGhh/.git/index.lock': File exists.

Another git process seems to be running in this repository, or the lock file may be stale
解決後できた · exit 0
rm -f .git/index.lock

2026-08-12 に alpine/git で実際に打って取った出力。検証環境の詳細

要約

fatal: Unable to create '/path/to/repo/.git/index.lock': File exists. は、git がインデックス(ステージング領域)を書き換える前に作る一時ファイル .git/index.lock が、すでに存在しているために起きる。
git は index を更新する操作の間だけこのロックファイルを作り、終わると自動的に消す。
前回のコマンドが途中で落ちるとロックが残り、次の commit や add が「まだ誰かが書き込み中」と判断して止まる。

fatal: Unable to create '/path/to/repo/.git/index.lock': File exists.
 
Another git process seems to be running in this repository, e.g.
an editor opened by 'git commit'. Please make sure all processes
are terminated then try again.

実行例

alpine/git のコンテナで同じ手順をたどると、動いている git プロセスが 1 つも無い状態でも git add は終了コード 128 で止まった。
ロックファイルを消したあとは、add も commit もそのまま通った。

$ ls -la .git/index.lock
-rw-r--r--    1 root     root             0 Aug 12 13:17 .git/index.lock
$ git add f.txt
fatal: Unable to create '/tmp/tmp.eoPGhh/.git/index.lock': File exists.
 
Another git process seems to be running in this repository, or the lock file may be stale
$ echo $?
128
$ ps aux | grep git
(動作中の git は無し)
$ rm -f .git/index.lock
$ echo $?
0
$ git add f.txt
$ git commit -m "init"
[main (root-commit) 8685643] init
 1 file changed, 1 insertion(+)
 create mode 100644 f.txt
$ echo $?
0
$ git status --short
$ git log --oneline
8685643 init

— 2026-08-12 時点の出力

検証環境2026-08-12 検証
検証日
実行環境
alpine/git

この記事の「実行例」は、上記の環境で実際にコマンドを実行して得られた出力をそのまま掲載しています。 再現手順はリポジトリの検証スクリプトとして管理し、定期的に再実行して出力を更新しています。

解決策

1. 進行中の git が無いか確認してから削除する

まず、本当に他の git が動いていないことを確かめる。
動いていれば、それが終わるまで待つ。
動いていなければロックファイルを消す。

# まず状況を確認(必要なら ps で git プロセスを探す)
ps aux | grep git
 
# 動いている git が無いと確認できたら削除
rm -f .git/index.lock
git status

Windows のエクスプローラやコマンドからでも、リポジトリ直下の .git/index.lock を削除すれば同じだ。
.git フォルダは隠し属性なので、隠しファイルを表示する設定にしてから探す。

2. エディタ・IDE の同時実行を止める

VS Code の Git 連携や自動 fetch、常駐する Git GUI が原因のことが多い。
それらを一度閉じるか Git 連携を無効化してからコマンドを実行し直すと、再発を防げる。

3. 中断した操作をやり直す

ロックを消しても index 自体は壊れていないのが普通だ。
git status で状態を確認し、commit などやり残した操作を改めて実行する。
状態が不整合に見えるときは git reset で index を作り直せる。

よくある原因

  1. 前回の git が異常終了した。
    kill -9 のように git が後始末できない止まり方だと、ロックが残る。
    エディタを保存せずに閉じた場合や Ctrl+C(SIGINT)では、git 自身がロックを消す。
    git commit -a は、メッセージのエディタを閉じるまでロックを持ち続ける。
  2. IDE やエディタの Git 連携とぶつかっている。
    VS Code などが裏で git status や自動 fetch を実行し、操作が衝突している。
  3. 別ターミナルで操作が進行中である。
    大きなリポジトリの add や gc が進行中で、正常に index をロックしている。
  4. ロックファイルを削除できない状態になっている。
    権限不足やファイルロックで、git 自身がロックファイルを消せていない。