Git多分支环境下重命名目录的正确方法

一、在feature1分支完成重命名并合并到main的正确步骤 #

1. 切换到feature1分支，使用Git原生命令重命名文件夹（不要手动修改文件夹名，否则Git无法识别为重命名操作，会被判定为删除旧目录+新增新目录）：

   git checkout feature1
   git mv labeling Newfeature
   

2. 提交重命名变更，提交信息明确说明操作：

   git commit -m "refactor: rename 'labeling' directory to 'Newfeature'"
   

3. 推送变更到远程feature1分支：

   git push origin feature1
   

4. 将feature1合并到main分支（如果用PR流程就走仓库的PR审核合并，命令行操作如下）：

   git checkout main
   git merge feature1
   git push origin main
   

二、其他分支（如feature2）rebase到main时的冲突处理 #

当其他分支仍保留labeling目录，rebase到已完成重命名的main分支时，大概率会出现冲突，按以下流程处理：

1. 切换到目标分支并启动rebase：

   git checkout feature2
   git rebase main
   

2. 遇到冲突时，Git会暂停rebase并提示冲突文件。此时：
   • 执行git status查看冲突位置，所有原labeling目录下的修改文件都会标记冲突
   • 将labeling目录下的修改内容迁移到Newfeature目录对应的文件中
   • 删除旧目录下的冲突文件：

     git rm labeling/[冲突文件名]
     

   • 将迁移后的新目录文件加入暂存：

     git add Newfeature/[对应文件名]
     

3. 处理完所有冲突后，继续rebase：

   git rebase --continue
   

4. 完成rebase后，手动将当前分支的labeling目录也重命名为Newfeature，同步目录结构：

   git mv labeling Newfeature
   git commit -m "refactor: sync directory name to Newfeature"
   

5. 推送变更到远程分支（因rebase修改了提交历史，需强制推送）：

   git push origin feature2 --force
   

三、提前规避冲突的优化建议 #

• 在将重命名分支合并到main前，通知所有维护feature分支的成员，先将各自分支rebase到已完成重命名的feature1分支，提前处理冲突，再合并到main，能大幅减少后续rebase的麻烦
• 若团队规模较小，可统一在main合并重命名后，协助所有分支完成目录迁移和rebase操作，确保全部分支目录结构一致

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