git rm

git

書き方

git rm [--cached] [-r] <pathspec>

ファイルを索引とディスクの両方から消します。--cachedはファイルを残して追跡だけ止めますが、過去の中身は履歴に残るので漏れた秘密は消えません。

よく使うオプション

オプション意味
--cachedstop tracking but leave the file on disk
-rrecurse into directories
-fremove even when the file has unstaged changes
-ndry run
--ignore-unmatchexit 0 even if nothing matched

git rm --cached .env

stops tracking a secret file while keeping it locally

git rm -r build/

deletes the folder from the repository and from disk

git rm -n "*.log"

shows what would be removed

取り消しに何通りもあるのが混乱のもとです — ブランチの指す先を動かすのと、打ち消すコミットを積むのは別です。

読み方

  • 角括弧 [ ] は省いてよい部分です。
  • 三点 … は複数並べられるという意味です。
  • オプションは大文字小文字を区別します — -r と -R が別物のコマンドもあります。

よくある質問

Q. git rm は何をしますか。

ファイルを索引とディスクの両方から消します。--cachedはファイルを残して追跡だけ止めますが、過去の中身は履歴に残るので漏れた秘密は消えません。

Q. どう打ちますか。

git rm [--cached] [-r] <pathspec> — 角括弧は省いてよい部分です。

Q. よく使うオプションはいくつですか。

ここにまとめたのは5個です。全部は man git にあります。このコマンドはgitの仲間です。

関連するコマンド

man ページ: man git-rm