首页/开发/Git 与协作速查/git mv 移动与重命名
Git 基础与命令88 条

git mv 移动与重命名

移动或重命名文件并同步索引;Git 按内容相似度识别重命名,先 mv 再 add 与 git mv 的最终效果接近。

Git 与协作速查开发更新于 2026-10-12
用途重命名/移动并同步暂存区
语法git mv <源> <目标>
相关git log --follow 跟踪重命名前后历史

常用示例

常用示例
git mv a.txt b.txt
git mv src lib
mkdir -p docs && git mv README.md docs/README.md
git log --follow docs/README.md
重命名不会保存「重命名」标记,而是靠相似度推断;一次移动大量文件时尽量单独成一个提交。

易错点

  • 用系统 mv 后忘记 git add,status 会显示为删除加未跟踪,容易误提交不完整变更
  • --follow 只对单个文件有效,多文件改名时用它逐个查历史

数据来源与参考

  • Git 官方文档:git-mv
  • Git 官方文档:git-log(--follow)
​‌‌​​‌​​​‌‌​‌‌‌‌​‌‌​​​‌‌​‌‌‌​​‌‌​​‌​‌‌‌​​‌‌‌​​​‌​‌‌​‌​​‌​‌‌‌​​​‌​‌‌​‌​​‌​‌‌​​​‌‌​‌‌‌​‌​​​‌‌​‌‌‌‌​​‌​‌‌‌​​‌‌​​​‌‌​‌‌​‌‌‌‌​‌‌​‌‌​‌