在Intellij中从Ant迁移到Gradle时如何保留原有Git信息

现有方案评估 #

• 方案1（直接复制.git保留Ant文件）：不推荐。会遗留大量冗余的Ant构建、旧IDE配置文件，后续回溯历史时容易混淆新旧构建体系的对应文件，也会占用不必要的仓库空间。
• 方案2（旧仓库先清非源码文件再迁移）：思路可行，但存在更简便的操作方式，无需手动复制源码，即可完整保留所有提交、标签、分支历史，同时适配新Gradle项目的结构。

推荐操作步骤（本地操作无风险） #

操作前请先备份旧Ant项目的完整仓库，避免误操作丢失数据：

1. 进入已配置完成的Gradle项目根目录，若未初始化Git则执行：
   git init
2. 将本地旧Ant仓库添加为当前项目的临时远程源：
   git remote add old-repo 旧Ant项目的本地绝对路径（例：C:\workspace\old-ant-lib）
3. 拉取旧仓库的所有历史数据、标签、分支：
   git fetch old-repo --tags
4. 合并旧仓库主干分支的历史，允许无关历史合并：
   git merge old-repo/master --allow-unrelated-histories
   （如果旧仓库主干分支是main，把命令里的master替换为main即可）
5. 此时项目中会同时存在旧Ant配置和新Gradle配置，手动删除所有不需要的旧Ant构建文件、旧IDE配置文件后提交变更：
   git add .
git commit -m "chore: 切换为Gradle构建，清理旧Ant相关配置"
6. 移除临时添加的旧仓库远程源：
   git remote remove old-repo

验证与后续优化 #

• 操作完成后可执行git log、git tag命令，确认所有历史提交、版本标签均完整保留，源码的每一段修改历史都可正常追溯
• 建议将Intellij自动生成的.idea目录、Gradle的.gradle目录添加到.gitignore文件，避免提交本地IDE临时配置
• 若旧项目源码目录结构与Gradle默认的src/main/java结构不一致，直接在Intellij中移动文件即可，Git会自动识别文件移动/重命名操作，不会中断单文件的历史追溯

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