【Git】Unlink of file failed. Should I try again? の原因と対処法｜OS別・操作別に完全解説

この記事で分かること

• 「Unlink of file failed」エラーの意味と仕組み
• 5つの原因（ファイルロック・権限・ウイルス対策・OneDrive・packファイル）
• OS別の対処法（Windows / Mac / Linux）
• 操作別の対処法（checkout / pull / merge / rebase / gc）
• 再発を防ぐ予防策と設定

エラーメッセージ例

Unlink of file 'src/index.js' failed. Should I try again? (y/n)

対処法

① エディタ / IDE を完全に閉じる（最小化ではなく終了）
② ターミナルでGit操作を再実行する
③ VS Code を使っている場合、統合ターミナルではなく外部ターミナルから実行するのも有効

権限の確認と修正（Linux / Mac）

# ファイルの所有者を確認
ls -la src/index.js

# 出力例（root所有になっている）
-rw-r--r-- 1 root root 1234 Mar 1 12:00 src/index.js

# 所有者を現在のユーザーに変更（再帰的に全体を修正）
sudo chown -R $(whoami):$(whoami) .

# ファイルのパーミッションを修正
chmod -R 755 .

予防：Gitでsudoを使わない

sudo git pullのようにGitコマンドにsudoを付けると、生成・更新されるファイルがroot所有になります。Gitコマンドは原則としてsudoなしで実行してください。権限エラーの対処法は「Permission denied (publickey) エラーの解決方法」も参照してください。

対処法

① Windows Defenderの設定で、リポジトリのフォルダを「除外」に追加する
Windows セキュリティ → ウイルスと脅威の防止 → 設定の管理 → 除外
② 一時的にリアルタイム保護を無効化してGit操作を実行し、終了後に再度有効化する

対処法

① リポジトリをクラウド同期フォルダの外に移動する（推奨）
② 同期対象フォルダからリポジトリを除外設定する
③ 移動が難しい場合は、Git操作中だけ同期を一時停止する

packファイルのエラー例

Unlink of file '.git/objects/pack/pack-abc123...def.pack' failed.
Should I try again? (y/n)

対処法

① すべてのエディタ・IDEを完全に終了する
② 外部ターミナルを新規に開き、git gc を再実行する
③ それでも解決しない場合はPCを再起動してからgit gcを実行

Process Explorer でファイルロックを調査

1. Process Explorer をダウンロード・起動
   https://learn.microsoft.com/sysinternals/downloads/process-explorer

2. Ctrl+F で「Find Handle or DLL」を開く

3. エラーメッセージに表示されたファイル名を入力して検索
   例: index.js や pack-abc123.pack

4. 該当プロセスを特定して終了する

PowerShell — ファイルをロック中のプロセスを特定

# ハンドルを検索（管理者権限のPowerShellで実行）
handle.exe index.js

# handleがない場合はopenfilesコマンドも使える
openfiles /query /fo csv | findstr "index.js"

Mac / Linux — lsof でファイルを使用中のプロセスを特定

# ファイルを使用しているプロセスを検索
lsof src/index.js

# .git ディレクトリ内のロックを確認
lsof +D .git/objects/pack/

# 特定のプロセスを終了（PIDは lsof の結果で確認）
kill -9 <PID>

gc.auto の設定

# 自動gcを無効にする（手動でgc管理する場合）
git config gc.auto 0

# 閾値を上げる（デフォルトは6700）
git config gc.auto 10000

# 確認
git config --get gc.auto

Windows 環境向けの推奨Git設定

# core.longpaths: 260文字のパス長制限を回避（深い階層のプロジェクト向け）
git config --global core.longpaths true

# core.protectNTFS: NTFSの予約名ファイルの保護
git config --global core.protectNTFS true

# pack.threads: パック処理のスレッド数を制限（ロック競合を減らす）
git config --global pack.threads 1

VS Code settings.json に追加

{
    "files.watcherExclude": {
        "**/.git/objects/**": true,
        "**/.git/subtree-cache/**": true
    }
}

index.lock の削除

# ロックファイルを削除（Git操作が完全に終了していることを確認してから）
rm .git/index.lock

# Windowsの場合
del .gitindex.lock

最終手段：リポジトリの再クローン

# 1. 作業中の変更をパッチとして保存
git diff > ~/my-changes.patch

# 2. 別の場所にクローンし直す
cd ..
git clone <リモートURL> my-project-new

# 3. パッチを適用
cd my-project-new
git apply ~/my-changes.patch

注意：未コミットの変更を忘れずに保存

再クローンの前に、git stashやパッチでの保存を忘れると作業中の変更が失われます。消したファイルの復元方法は「Git 消したファイルを戻す方法」で解説しています。

Unlink of file failed の対処ポイント