TFS 2017构建代理工作文件夹设置及默认_work构建失败解决咨询

我来帮你梳理这两个TFS 2017构建代理的问题，结合实际运维经验给你详细解答：

1. 创建TFS 2017构建代理时应设置什么工作文件夹？ #

官方最推荐使用默认的_work文件夹作为构建代理的工作目录，原因如下：

• 这个目录的结构是TFS代理自动管理的，每个构建任务会在_work下生成独立的编号子目录（比如_work\1、_work\2），不同构建之间完全隔离，不会出现文件冲突或者残留文件干扰后续构建的问题。
• 除非你有特殊需求（比如当前磁盘空间不足需要更换分区、特定权限限制要求使用其他目录），完全没必要自定义工作文件夹，默认设置就能覆盖绝大多数场景。如果一定要自定义，确保目标文件夹有足够的读写权限，且路径不包含特殊字符或过长路径。

2. 使用默认_work文件夹时构建找不到项目文件的解决方法 #

从你提供的日志片段来看，构建刚进入Get Sources阶段就中断了，大概率是源代码下载路径和构建任务中的项目路径不匹配，或者源代码根本没成功下载。给你几个实用的排查和解决步骤：

• 核对Get Sources的映射配置
  进入你的构建定义的Get Sources步骤，确认源代码仓库的映射规则：默认情况下，TFS会把服务器上的代码库映射到代理工作目录下的\s子目录，也就是说源代码会被下载到_work\<构建编号>\s目录下。你需要确保Visual Studio Build任务中的项目路径是基于这个s目录的相对路径，比如如果解决方案文件在s\MyProject.sln，那任务里就写s\MyProject.sln，或者用通配符**\MyProject.sln（匹配所有子目录下的该文件）。

• 检查代理运行账户的权限
  运行TFS构建代理的服务账户（比如本地系统账户或者域账户）必须对_work文件夹拥有完整的读写权限。如果权限不足，源代码可能无法正常下载到_work目录下，自然会提示找不到项目文件。你可以手动右键_work文件夹，在“属性-安全”里给代理账户添加读写权限。

• 查看完整的Get Sources阶段日志
  你提供的日志只到Get Sources的开头部分，建议查看完整的日志内容，看看有没有源代码下载失败的提示（比如权限错误、仓库路径不存在等）。如果Get Sources阶段就报错了，后续的构建任务肯定找不到项目文件。

• 使用构建变量规范路径
  避免在构建任务里写死绝对路径（比如C:\MyProject\MyProject.sln），因为代理是在_work的动态子目录下工作的，绝对路径肯定不对。推荐使用TFS内置的构建变量来引用路径，比如用$(Build.SourcesDirectory)来指向源代码下载的根目录，然后拼接项目文件路径，比如$(Build.SourcesDirectory)\MyProject.sln，这样不管构建编号是多少，路径都是准确的。

附上你提供的构建日志片段：

2018-02-02T06:02:04.6000428Z ##[section]Starting: Build
2018-02-02T06:02:04.6020618Z Current agent version: '2.122.1'
2018-02-02T06:02:06.5920856Z ##[section]Starting: Initialize Job
2018-02-02T06:02:06.5990706Z Prepare build directory.
2018-02-02T06:02:06.7466794Z Set build variables.
2018-02-02T06:02:06.7501818Z Download all required tasks.
2018-02-02T06:02:06.8317393Z ##[section]Finishing: Initialize Job
2018-02-02T06:02:06.8702795Z ##[section]Starting: Get Sources
2018-02-02T06:02:06.9518235Z Prepending Path environment variable with directory containing 't...

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