首頁·終端機命令

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