从TFS迁移至Git时文件夹历史缺失的解决方案咨询

问题定位 #

你遇到的问题大概率是无参数的git-tfs clone仅拉取了TFS仓库默认根路径的分支历史，而Main、Utility这些文件夹在TFS中要么是独立的分支路径，要么历史变更集分散在不同路径范围里，导致git-tfs未完整抓取所有路径的历史数据。

迁移步骤 #

1. 先确认TFS项目结构 #

通过TFS命令行或Web后台确认文件夹归属：

• 检查Main、Utility、PostProcessor是否对应TFS中不同的分支（比如$/ProjectName/Main、$/ProjectName/Utility这类独立分支路径）
• 确认这些文件夹的历史变更集是否为独立维护

2. 分路径独立迁移（适配多分支文件夹场景） #

如果每个文件夹对应独立的TFS分支，建议分别克隆每个分支到单独的Git仓库，后续再通过Git子模块或仓库合并完成整合：

• 克隆Main分支：

  git tfs clone http://tfs-server:8080/tfs/Collection $/ProjectName/Main git-main-repo
  

• 克隆Utility分支：

  git tfs clone http://tfs-server:8080/tfs/Collection $/ProjectName/Utility git-utility-repo
  

• 克隆PostProcessor分支：

  git tfs clone http://tfs-server:8080/tfs/Collection $/ProjectName/PostProcessor git-postprocessor-repo
  

3. 单仓库整合多路径历史（适配同分支下多文件夹场景） #

如果所有文件夹都属于同一个TFS主分支，只是历史变更集分散在不同路径，克隆时指定完整根路径并加上--with-branches参数拉取所有关联分支，确保覆盖所有路径的历史：

git tfs clone http://tfs-server:8080/tfs/Collection $/ProjectName --with-branches git-full-repo

克隆完成后，进入Git仓库验证各文件夹历史：

git log --oneline -- Main/
git log --oneline -- Utility/

4. 处理空文件夹Release #

Git不直接支持空文件夹，迁移时可直接忽略该文件夹，或迁移后手动创建并添加.gitkeep占位文件保留目录结构。

5. 验证迁移完整性 #

完成迁移后，逐一核对每个文件夹的历史：

• 追踪单个文件的完整历史（含重命名/移动记录）：git log --follow -- Main/SomeFile.cs
• 对比TFS与Git的变更集数量，确认关键历史无遗漏

注意事项 #

• 迁移前务必备份TFS仓库，避免不可逆操作
• 若TFS历史变更集数量庞大，可通过--changeset参数指定起始变更集加速迁移：git tfs clone $/ProjectName --changeset=1234
• 若仍有历史丢失，可使用git tfs fetch补充抓取指定路径的变更集：git tfs fetch $/ProjectName/Main

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