`git mv` 重命名 Git 仓库中的文件夹
- 提交前，先
pull最新代码，再commit和push- 修改仓库中 文件夹名称：
git mvold new_name
在日常开发中，我们常常需要对项目结构进行调整，比如重命名文件或文件夹。
然而，在 Git 仓库中进行此类操作时，如果使用普通命令（如 mv），可能会导致 Git 无法正确识别变更，从而丢失文件的历史记录。
本文通过一个真实操作案例，详细介绍如何使用 git mv 命令安全、高效地重命名 Git 仓库中的文件夹，并确保版本控制信息完整保留。
🎯 场景描述
项目中有一个名为 test/ 的文件夹，其中包含了多个用于测试 Muduo 网络库 的 C++ 测试程序。随着项目演进，该名称已无法准确反映其内容。
为了提升代码可读性和维护性，决定将其重命名为更具语义的 muduo_test/。
目标：
- 将
test/文件夹重命名为muduo_test/ - 保留所有文件及其 Git 提交历史
- 确保远程仓库同步更新
🔧 操作步骤
1. 进入项目目录并检查当前状态
首先，进入项目根目录，并查看当前 Git 状态，确认工作区是干净的，避免与其他变更混淆。
cd /root/Cpp-Lib-test
git status
输出应显示 On branch main 且 nothing to commit, working tree clean，表示可以安全执行重命名操作。
2. 使用 git mv 执行重命名
Git 提供了专用命令 git mv 来处理文件和文件夹的移动或重命名操作。它能确保 Git 正确记录这一变更为“重命名”而非“删除+新增”。
git mv test muduo_test
此命令等价于：
- 删除原路径
test/（Git 层面标记为 deleted） - 创建新路径
muduo_test/（Git 层面标记为 added） - 但 Git 会通过内容比对识别为 rename
⚠️ 注意：不要使用系统
mv命令，否则 Git 会认为test/被删除，muduo_test/是新文件夹，导致历史丢失。
3. 验证文件系统变更
使用 ls 命令确认文件夹已成功重命名，并检查内部文件是否完整保留：
ls -la | grep muduo_test
输出应显示 muduo_test/ 存在，并包含原有的 9 个文件（包括 README.md 和 8 个 C++ 测试源码文件），确保无数据丢失。
4. 检查 Git 状态
查看 Git 对该操作的识别情况：
git status
预期输出片段：
Git 明确识别出多个文件的“重命名”操作，说明历史追踪完整。
5. 提交变更到本地仓库
将重命名操作作为一次提交保存：
git commit -m "rename test folder to muduo_test"
建议使用清晰的提交信息，便于团队协作和后期追溯。
6. 推送至远程仓库
将本地变更同步到远程仓库（如 GitHub、GitLab）：
git push origin main
推送完成后，可在远程仓库页面验证 test/ 已被替换为 muduo_test/。
7. 最终验证
再次检查当前目录，确认旧文件夹已不存在，新文件夹正常存在：
ls -la | grep -E "(test|muduo_test)"
仅应看到 muduo_test，无 test。
总结
| 项目 | 状态 |
|---|---|
| 旧文件夹 | test/ → 已移除 |
| 新文件夹 | muduo_test/ → 成功创建 |
| 文件完整性 | 9 个文件全部保留（含 8 个 C++ 测试文件） |
| Git 跟踪 | 正确识别为 rename 操作，历史记录完整 |
| 远程同步 | 已成功推送到 origin/main |
🌟 git mv 的三大优势
-
保留完整历史记录
Git 能追溯文件在重命名前的提交历史，执行git log muduo_test/README.md仍可看到其在test/时期的修改记录。 -
避免不必要的 diff 冲突
若使用rm + add，Git 会记录为“删除一批文件 + 新增一批文件”，在代码审查中造成大量无意义 diff。而rename仅显示路径变更。 -
原子性与安全性
git mv是原子操作，确保重命名过程不会因中断导致部分文件丢失或状态不一致。
📝 建议
- ✅ 始终使用
git mv处理 Git 仓库内的文件/文件夹移动或重命名。 - ✅ 提交信息应清晰描述变更目的，如
"refactor: rename test to muduo_test for clarity"。 - ✅ 对于大型项目，可在重命名后运行测试，确保构建系统能正确识别新路径。
- ✅ 若需跨分支重命名，建议在
主干合并后统一操作，减少冲突风险。
🎉 结语
通过本次操作，我们成功将 test/ 重命名为语义更明确的 muduo_test/，不仅提升了项目结构的可读性，也展示了如何在 Git 中安全地进行结构重构。
小命令，大作用：一个简单的
git mv，守护的是你宝贵的代码历史与团队协作效率。
下次当你需要调整项目结构时，记得优先使用 git mv，让 Git 成为你重构路上的可靠伙伴ovo