首页·终端命令

git mv

git

用法

git mv [-f] <source> <destination>

移动文件并顺手把这次改动放进暂存区;git 不保存重命名,而是靠内容相似度推断,所以只改大小写的重命名在 macOS 和 Windows 上需要 -f。

常用选项

选项含义
-foverwrite the destination
-kskip moves that would fail instead of stopping
-ndry run
-vname each file as it moves

示例

git mv old.md docs/new.md

moves the file and stages the change in one step

git mv -n src/a.ts src/b.ts

shows what it would do

git mv README.md readme.md

a 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