Azure DevOps Server 2019(TFVC)如何打破文件夹错误合并关联？

问题现象 #

• 尝试合并Branch A下的child folder X到Branch B时，Visual Studio的合并向导会默认把目标路径指向Branch B的child folder Y，而非同名的child folder X
• 直接合并分支根目录时，路径匹配完全正常

推测原因 #

• 原child folder X曾通过「删除+新建」的方式做过重命名操作，之后被复用为其他Visual Studio项目的文件夹，导致TFVC的历史路径关联出现混乱
• 存在误操作记录：曾有用户错误地将内容合并到child folder Y，让TFVC建立了错误的合并关联关系

造成的影响 #

• 部分用户没留意到默认路径错误，直接完成合并，导致代码被合并到错误位置，引发后续的修正工作
• 曾出现过文件误删的情况（可通过回滚恢复），增加了额外的运维成本

需求目标 #

• 打破child folder X与child folder Y之间的错误关联，让Visual Studio合并向导默认指向正确的目标文件夹
• 不废弃现有分支，保留完整的历史记录
• 接受风险可控的数据库直接修改操作

可行解决方案 #

1. 用TFVC命令行强制建立正确合并关联 #

使用tf merge命令手动指定源和目标路径，执行一次强制合并，覆盖TFVC的错误默认映射：

tf merge $/YourProject/BranchA/child folder X $/YourProject/BranchB/child folder X /recursive /force /noautoresolve

• 执行该命令后，TFVC会记录这次正确的路径关联，后续使用Visual Studio合并向导时，会优先采用这个正确的映射作为默认路径
• 执行前建议先拉取最新代码，避免冲突

2. 清理TFVC数据库中的错误合并关联（谨慎操作） #

如果命令行方式无效，可以考虑直接修改TFVC数据库的关联记录（必须先备份完整数据库）：

• 找到存储合并关联的表tbl_MergeRelationship，查询涉及child folder X和child folder Y的关联条目
• 删除其中源路径为Branch A的child folder X、目标路径为Branch B的child folder Y的错误条目
• 注意：仅修改确认错误的记录，避免影响其他正常的合并关联

3. 手动标记正确合并基线 #

在Visual Studio合并向导中，每次合并时手动指定正确的目标路径，完成合并并提交。多次操作后，TFVC会基于最近的合并历史更新默认推荐路径，逐步覆盖错误关联

补充注意事项 #

• 无法回滚最初建立错误关联的操作，只能通过重置或覆盖关联的方式修复
• 仅在直接合并单个文件夹时出现默认路径错误，合并分支根目录时无此问题
• 修复完成后，需通知所有用户测试合并流程，确认默认路径已恢复正确

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