Gitのキャッシュをクリアする方法を徹底解説

Gitを使っていると、.gitignoreファイルに新しい行を追加したのに、無視したはずのファイルが「git commit」のステージングエリアに表示され続けることがあります。このような問題に直面したとき、最も効果的な解決策はGitのキャッシュをクリアすることです。この記事では、Gitキャッシュのクリア方法を詳しく解説します。その前に、Gitキャッシュとは何か、どのような役割を持つのか、クリアすることでどんなメリットがあるのかを簡単に確認しておきましょう。

Gitキャッシュとは？

Gitキャッシュ（ステージングエリアまたはインデックスとも呼ばれます）には、ワーキングツリーディレクトリの情報が含まれており、リポジトリ、コミット、ブランチなど、「git commit」コマンドを実行した時点でコミットされる予定のデータが格納されています。

キャッシュを利用することで、コミット前にワーキングツリーへの変更を選択的に反映したり、最新のコミットだけを取得して他のデータはキャッシュから参照したりすることが可能になります。

もしGitキャッシュが存在しなければ、コミットのたびに変更内容がワーキングツリーへ不便な形で戻されたり、次回のコミット時に一部の変更だけを再コミットするといった非効率な動作が発生してしまいます。

Gitキャッシュの役割

ステージングエリア（インデックス）の主な目的は、パフォーマンスの向上です。具体的には、競合するコミットのマージを解決したり、依存関係やライブラリなどのコンテンツを必要になるたびに再ダウンロードする手間を減らすことで、開発作業の効率を高めます。

Gitキャッシュの場所と確認方法

Gitキャッシュは、.gitディレクトリ内にある「index」という名前のファイルに保存されています。

まず、以下のコマンドで.gitディレクトリの場所を確認し、cdコマンドでそのディレクトリに移動します。

git rev-parse --git-dir
cd .git

ディレクトリに移動したら、lsコマンドでindexファイルを探します。

ls -la

ファイルの詳細を確認するには、fileコマンドを使用します。

file index

このコマンドを実行すると、ファイルの種類、バージョン、Gitキャッシュファイル内のエントリ数が出力されます。

index: Git index, version 2, 5 entries

Gitキャッシュファイルをクリアする

特定のファイルだけをGitキャッシュから削除したい場合は、git rmコマンドに続けて対象のファイル名を指定します。

ディレクトリ内のファイルをまとめて再帰的に削除したい場合は、-rオプションを付けます。

コマンドの基本構文は以下のとおりです。

git rm --cached ファイル名

「ファイル名」の部分を、キャッシュから削除したい実際のファイル名に置き換えてください。

例えば、「mte-info.c」というファイルを削除する場合は、次のコマンドを実行します。

git rm --cached mte-info.c

その後、以下のコマンドでファイルが正常に削除されたかどうかを確認できます。

file .git/index

注意： git rm --cached ファイル名コマンドを実行しても、ファイルがワーキングディレクトリから削除されるわけではありません。あくまでステージングエリアから除外されるだけなので安心してください。

一方、キャッシュとステージングエリア全体を一括でクリアしたい場合は、git rmコマンドに再帰的な-rオプションを付けて実行します。

git rm -r --cached

まとめ

この記事で紹介したように、Gitキャッシュのクリアは簡単なコマンド操作で行えます。.gitignoreの設定がうまく反映されないときは、ぜひ本記事の手順を試してみてください。また、Gitエイリアスを活用すれば日常のGit操作をさらに効率化できるので、合わせて学んでおくとよいでしょう。