git rmコマンド徹底解説：Gitリポジトリからファイルを削除する完全ガイド

git rmコマンドは、Gitリポジトリからファイルを削除するためのコマンドです。このコマンドは、ファイルシステム上のファイルを削除したうえで、Gitリポジトリが追跡しているファイル一覧からもそのファイルを取り除きます。–cachedオプションを使えば、ローカルのファイルシステムには残したまま、Gitリポジトリからだけファイルを削除することも可能です。

「Gitリポジトリからファイルを削除するにはどうすればいいのか？」——これは多くの開発者が抱く素朴な疑問です。プロジェクトにとって不要になったファイルを、ずっとリポジトリに入れ続けたいとは限りません。そんなときは、Gitリポジトリからファイルを削除したくなるでしょう。

Gitリポジトリからファイルを削除するには、git rmコマンドを使用します。git addコマンドがファイルを追加するのに対し、git rmはファイルを削除する、まさに正反対の役割を持つコマンドです。

本ガイドでは、git rmコマンドの使い方について詳しく解説します。実際の例を通して、このコマンドがどのように動作するのかを見ていきましょう。それでは始めます！

Gitにおけるファイル管理の仕組み

git rmコマンドの使い方を説明する前に、まずGitバージョン管理システムにおいてファイルがどのように管理されているのかを理解しておきましょう。

Gitリポジトリ内のファイルは、「トラック済み（tracked）」か「未トラック（untracked）」のいずれかに分類されます。

トラック済みファイルとは、git commitに一度でも含まれたことのあるファイルのことです。一方、未トラックファイルとは、まだリポジトリにコミットされていないファイルを指します。一般的に、未トラックファイルとは、コミットを作成する前に新しく作成したファイルのことを意味します。

ファイルをGitコミットに追加するには、git addコマンドを使います。これにより、そのファイルはトラック済みになります。逆に、ファイルの追跡をやめたい場合には、git rmコマンドを使用します。

git rmコマンドは、1つまたは複数のファイルをGitリポジトリから削除します。デフォルトでは、ファイルはローカルマシンとGitリポジトリの両方から削除されます。ローカルマシン上のファイルを残したい場合は、–cachedオプションを使用してください。

オプションを何も付けずに実行すると、このコマンドはGitリポジトリとローカルの作業ディレクトリの両方からファイルを削除します。つまり、Linuxのrmコマンドがコンピュータからファイルを削除するのと同じように、ファイルそのものが消去されるのです。

このコマンドの最もシンプルな使い方は、単一のファイルを削除することです。ここでは、settings.jsonというファイルをGitリポジトリから削除してみましょう：

git rm settings.json

このコマンドにより、settings.jsonがリポジトリの追跡対象から削除されます。同じコマンドで複数のファイルをまとめて削除することもできます。その場合は、削除したいファイルやフォルダ名をスペースで区切って指定します：

git rm settings.json .env

これで、settings.jsonと.envの両方のファイルがリポジトリから削除されます。

デフォルトでは、rmコマンドでパスをアンステージして削除する際に、Gitは安全チェックを行います。これは、現在のブランチ上のファイルがステージングインデックス内のファイルと一致しているかどうかを確認するためです。-f（--force）オプションを使うと、この安全チェックをスキップできます。

-fオプションは、ファイルを本当に削除したいと確信できる場合にのみ使用してください。安易に使うと、後でマージコンフリクトが発生する原因になることがあります。万一コンフリクトが発生した場合は、マージコンフリクトの解決方法を解説したガイドが役立ちます。

git rm --cached の使い方

git rm --cachedオプションは、ステージングエリアからのみファイルを削除します。作業ディレクトリ内のファイルはそのまま残るため、ローカルには引き続きファイルのコピーが保持されます。つまり、Gitプロジェクトを追跡しているインデックスからだけ、ファイルが取り除かれるのです。

試しに、settings.jsonを作業ツリーからは削除せず、プロジェクトディレクトリには残したまま、リポジトリの追跡対象からだけ外してみましょう：

git rm --cached settings.json

次回のコミットをプッシュすると、settings.jsonファイルがリポジトリから削除されます。

なお、ローカルの作業ディレクトリにファイルが存在する限り、git addコマンドを使っていつでも再びGitリポジトリに追加し直すことができます。git addコマンドの詳細については、git addコマンド専用のチュートリアルをご覧ください。

git rmコマンドの取り消し方法

git rmコマンドによる変更は、コミットが実行されるまではステージングエリアと作業ディレクトリにしか反映されていません。つまり、コマンドを取り消すことが可能です。git rmコマンドを元に戻すには、git resetを使ってリポジトリを直前のコミットの状態へリセットします：

git reset HEAD

GitのHEADコミットは、リポジトリにおける最新のコミットを表します。したがって、このコマンドを実行すれば、リポジトリは直前のコミット時点の状態に戻ります。

さらに、すでに変更をコミットしてしまった後であっても、git rmコマンドを取り消すことはできます。その場合は、git resetコマンドに、戻りたいコミットのハッシュを指定しましょう：

git reset a7e3cce9637c74281e6590003b39d3990bbb2731

ここでは、リポジトリをひとつ前のコミットの状態に戻しています。「reset」の後ろに続く英数字の文字列が、直前のコミットのハッシュです。

リポジトリを元に戻すと、コミット前の状態を確認できます。このとき、ファイルは再びステージされた状態になります。言い換えれば、git rmコマンドが取り消されたということです。

git rm と rm の違い

git rmコマンドは、ローカルマシンとGitリポジトリの両方からファイルを削除します。一方、通常のrmコマンドは、Gitリポジトリからファイルを削除することができません。

Gitリポジトリからファイルを削除したい場合は、必ずgit rmを使用してください。これは、git rmコマンドが「Gitリポジトリからファイルを削除する」という一連の処理を実行するように設計されているためです。Linuxシステム上のすべてのファイルがGitリポジトリに含まれているわけではないため、Linux標準のrmコマンドはGitリポジトリの管理情報を更新しないのです。

まとめ

git rmコマンドを使えば、Gitリポジトリと作業ディレクトリの両方からファイルを簡単に削除できます。Gitリポジトリからのみファイルを削除したい場合は、–cachedオプションを活用しましょう。

「Career Karmaは、人生で最も支援が必要だったタイミングで現れ、すぐに自分に合ったブートキャンプとのマッチングを助けてくれました。卒業からわずか2ヶ月後、私の価値観や人生の目標に合致した理想の仕事を見つけることができました！」

Venus氏／Rockbot ソフトウェアエンジニア

自分に合ったブートキャンプを見つけよう

これであなたも、コマンドラインのエキスパートのようにgit rmコマンドを使いこなせるはずです！

Gitの操作についてさらに学びたい方は、Gitの学習ガイドもぜひ参考にしてください。