git重命名文件和文件夹实现方式方式实用指南

作者：袖梨 2026-09-29

平时做技术实践时，很多问题不是概念不会，而是细节没串起来。拿“git重命名文件和文件夹实现方法方式”来说，它看着像小点，放到项目里常会牵出环境、配置、兼容性和维护成本。下面按实际采用顺序，把思路、关键写法和容易踩坑的地方讲清楚，便于大家直接对照操作。

前情提要

实际处理时，想修改一下我的某个文件/文件夹名字，发现一改，怎么这个文件绿色的 √ 就没了？？？改回来之后，√ 又回来了！！！咋回事呢？

结合项目来看，别急， Git 追踪文件是根据文件名来的，把文件名改了，它就不知道那该死的文件去哪了，它就以为你删掉了！！！

结合项目来看，所以你在本地直接改名一个文件之后，git status 发现的就是 deleted 和 untracked。但这不是我的本意啊！！！

落到代码里，所以想要修改文件名，我们就需用到 git mv 命令了。

git mv 详解重命名

重命名文件或文件夹能够采用 git mv 命令。

参数详解：

-v：显示信息。
-f：强制重命名或移动，会覆盖目标文件。
-k：跳过对重命名或移动出错的文件。出错的时候发生在源文件不存在，或者没有追踪的源文件，或者目标文件已经存在，但没有加-f进行覆盖。
-n：只显示信息，但不会进行实际重命名或移动操作。

注意文件状态：

只能修改已经追踪的文件和文件夹
修改之后，相当于执行了 add，直接 commit 就能够提交。

重命名文件

-f 指强制重命名或移动，注意：若目标已经存在，则会覆盖目标文件。

$ git mv -v oldfile newfile
# $ git mv -f oldfile newfile

# 已经追踪，无需进行 add -u
$ git status
Changes to be committed:
  (use "git reset HEAD <file>..." to unstage)

        renamed:    oldfile -> newfile

# 重命名之后正常 commit push 就可以了
$ git commit -m "rename oldfile to newfile"
$ git push

重命名文件夹

/ 不会产生影响。

结合项目来看，若 newfolder 文件夹原本已经存在，则会将 oldfolder 移入 newfolder。

$ git mv -v oldfolder newfolder
# $ git mv -v oldfolder/ newfolder/

# 已经追踪，无需进行 add -u
$ git status
Changes to be committed:
  (use "git reset HEAD <file>..." to unstage)

        renamed:    oldfolder/... -> newfolder/...

# 重命名之后正常 commit push 就可以了
$ git commit -m "rename oldfolder to newfolder"
$ git push