如何修复TFS中目录大小写更名引发的Linux构建异常问题？

刚好之前处理过类似的TFS跨平台大小写问题，结合你用的TFS 2018 Update 2版本，给你逐个解答：

1. 为何重命名文件夹未递归修改Server Name？该如何修复？ #

原因 #

TFS的版本控制模型里，每个文件、子文件夹都是独立的版本化对象。当你重命名父文件夹（从foo到Foo）时，默认只会修改父文件夹本身的Server Path，不会自动递归更新所有子项的Server Name——这是为了保留完整的历史追溯链，避免改写子项的原始路径记录。而Windows文件系统本身大小写不敏感，所以在Windows客户端操作时，这个问题被隐藏了，客户端会自动把两种大小写的路径映射到同一个实际目录。

修复步骤 #

1. 先确保所有相关工作区的变更都已签入或搁置，避免后续操作冲突。
2. 使用TFS命令行工具tf.exe批量修正子项路径：
   • 创建一个临时工作区，映射到包含问题目录的项目路径。
   • 运行递归重命名命令，把所有子项的Server Path前缀从foo改为Foo：

     tf rename "$/YourProject/foo/*" "$/YourProject/Foo/*" /recursive
     

   • 检查生成的变更列表，确认所有子项的重命名操作都被正确捕获，然后签入这个变更集。
3. 签入后，新的Get Source操作就会统一拉取到Foo目录，不会再出现大小写分裂的情况。

2. 是否可回溯修复此问题，以便能够构建旧版本？ #

可以，但要根据旧版本的使用频率选择不同方案：

• 如果需要频繁构建旧版本：
  针对目标旧版本创建一个分支，在分支中执行上述的递归重命名操作，修复所有子项的路径大小写问题，之后基于这个修复后的分支构建旧版本即可。这样既不影响主分支的历史，又能解决旧版本的构建问题。
• 如果只是偶尔构建旧版本：
  可以在Linux构建代理上临时处理：
  1. 在构建脚本中添加预处理步骤，合并大小写目录：

     if [ -d "foo" ]; then
         cp -r foo/* Foo/
         rm -rf foo
     fi
     

  2. 或者临时开启ext4文件系统的大小写不敏感（需要卸载分区后操作，仅建议在专门的构建机器上使用）：

     sudo tune2fs -o casefold /dev/sdXn
     

• 注意：TFS本身会保留每个变更集的原始路径，所以直接拉取旧变更集时，若该变更集存在混合大小写的路径，还是会在Linux上生成双目录，上述方案是绕过这个问题的实际手段。

3. 是否有选项可强制Linux下的Get Source步骤忽略大小写或实现类似效果？ #

TFS 2018 Update 2的官方构建代理没有直接提供忽略大小写的配置，但有几个实用的替代方案：

• 方案一：自定义工作区映射
  在构建定义的Get Source步骤中，进入“Advanced”设置，选择“Private”工作区，然后手动添加映射规则：将$/YourProject/foo和$/YourProject/Foo都映射到本地的同一个目录（比如$(Build.SourcesDirectory)/Foo）。注意要测试映射逻辑，避免文件覆盖风险。
• 方案二：构建脚本预处理
  在Get Source步骤之后添加一个Bash/PowerShell脚本，自动检测并合并大小写不同的目录，示例脚本参考问题2中的合并代码。
• 方案三：升级到更高版本（可选）
  后续的Azure DevOps Server（原TFS）版本对跨平台路径大小写处理做了优化，增加了路径规范化的相关选项，但如果暂时无法升级，前两个方案足够解决问题。

内容的提问来源于stack exchange，提问作者C.M.