git mv
git
用法
git mv [-f] <source> <destination>移動檔案並順手把這次改動放進暫存區;git 不儲存重新命名,而是靠內容相似度推斷,所以只改大小寫的更名在 macOS 和 Windows 上需要 -f。
常用選項
| 選項 | 含義 |
|---|---|
| -f | overwrite the destination |
| -k | skip moves that would fail instead of stopping |
| -n | dry run |
| -v | name each file as it moves |
範例
git mv old.md docs/new.mdmoves the file and stages the change in one step
git mv -n src/a.ts src/b.tsshows what it would do
git mv README.md readme.mda case-only rename, which needs -f on macOS and Windows
難的地方在於復原有好幾種:把分支的指向挪走,和補一個反向提交,不是一回事。
怎麼看
- 方括號 [ ] 表示這部分可以不寫。
- 省略號 … 表示可以寫多個。
- 選項區分大小寫——有些命令裡 -r 和 -R 不是一回事。
常見問題
Q. git mv 是做什麼的?
移動檔案並順手把這次改動放進暫存區;git 不儲存重新命名,而是靠內容相似度推斷,所以只改大小寫的更名在 macOS 和 Windows 上需要 -f。
Q. 怎麼寫?
git mv [-f] <source> <destination> —— 方括號表示可以省略的部分。
Q. 值得記的選項有幾個?
這裡列了 4 個,完整列表在 man git。這條命令屬於git。
相關命令
man 手冊: man git-mv