Git如何从初始提交起重命名文件/目录且不保留重命名记录？

算力阿峰

2026-7-8

解决方案：用git filter-repo批量改写历史文件名

要实现从提交链源头就替换文件名、完全抹除原文件的历史痕迹，最高效的方式是用git filter-repo工具，它能自动遍历所有提交历史，批量替换文件名，无需手动处理大量冲突：

第一步：先备份仓库
因为改写历史是不可逆操作，先复制整个仓库目录到其他位置，防止操作失误丢失数据。
第二步：安装git filter-repo
大部分新版Git已经集成了这个工具，如果你的Git版本没有，可通过以下方式安装：
- Ubuntu/Debian：sudo apt install git-filter-repo
- macOS：brew install git-filter-repo
- 通用方式：pip install git-filter-repo
第三步：执行文件名替换
针对单个文件（foo.txt → bar.txt）：
```
git filter-repo --path-rename foo.txt:bar.txt
```
针对目录重命名（比如foo/目录 → bar/目录）：
```
git filter-repo --path-rename foo/:bar/
```
这个命令会自动遍历从C1到C50的所有提交，把所有涉及原文件/目录的创建、修改记录，全部替换成目标文件名/目录名。执行完成后，你的提交链会保持C1-C2-...-C50的结构，但C1中创建的是bar.txt，后续所有提交都是针对它的，不会留下任何重命名相关的日志或状态。
第四步：同步到远程仓库（如果需要）
因为历史已被改写，需要强制推送到远程：
```
git push --force
```
注意：如果是多人协作的仓库，必须通知所有协作成员重新拉取最新历史，避免后续提交冲突。