如何在VS Code中通过Git成功重命名及移动文件

直接用VS Code图形界面操作 #

• 打开左侧资源管理器，找到目标文件
• 右键选「重命名」（或按F2）修改文件名；移动文件直接拖拽到目标文件夹
• 此时源代码管理面板会显示该文件为重命名：旧路径 -> 新路径，而非分开的删除/新增记录
• 直接提交该变更，Git会正确记录为重命名操作

用Git命令行操作 #

如果偏好命令行，在终端执行：

git mv 旧文件路径 新文件路径

示例：将src/utils/oldHelper.js移动并重命名为src/tools/newHelper.js

git mv src/utils/oldHelper.js src/tools/newHelper.js

执行后查看Git状态会显示重命名记录，正常提交即可。

修复已出现的错误状态（旧文件删除、新文件未追踪） #

如果已经手动修改文件名导致Git误判，按以下步骤修复：

1. 先撤销当前异常状态：

git restore 旧文件路径
git rm --cached 新文件路径

2. 再用git mv重新执行重命名；或者直接让Git关联两个文件：

git add 旧文件路径 新文件路径

3. 此时Git会识别为重命名操作，提交即可。

注意点 #

• 确保VS Code的Git插件处于启用状态（默认启用），插件异常可能导致无法自动识别重命名
• 尽量在VS Code内或用git mv操作文件，避免直接在系统文件管理器修改后回到VS Code，防止Git误判

内容的提问来源于stack exchange，提问作者Rodrigo