TFS构建代理文件夹多版本NuGet.exe原因及VNext构建版本处理咨询

我来帮你拆解下TFS 2018 VNext构建里NuGet版本的底层逻辑，刚好对这块比较熟悉：

为什么代理文件夹里会有多个NuGet.exe版本？ #

• 按需缓存，支持多版本并行：NuGet工具安装器任务的核心是下载指定版本到代理的工具缓存目录，而不是覆盖已有的版本。你的代理路径下应该有类似C:\dev\tfs_bld_agents\scully\_work\_tool\NuGet的文件夹，每个子目录对应一个下载过的NuGet版本。这种设计是为了让不同的构建定义可以同时使用不同的NuGet版本——比如一个定义用4.3.0，另一个用5.x，代理不需要重复下载，直接复用缓存好的版本，提升构建效率。
• 代理自带默认版本：TFS 2018的构建代理本身会预装一个默认的NuGet版本（通常是对应TFS发布时的稳定版本），这个版本也会存放在代理目录里，所以你会看到多个版本共存。

后续构建任务的NuGet版本处理机制 #

当你通过NuGet工具安装器指定了4.3.0版本后，后续任务的版本选择是这样运作的：

• 环境变量标记指定版本：NuGet工具安装器任务执行完成后，会在当前构建的上下文里设置一个名为NUGET_EXE的环境变量，其值就是你指定的4.3.0版本NuGet.exe的完整路径。
• 任务优先读取环境变量：后续的NuGet相关任务（比如NuGet还原、NuGet打包）默认会优先读取这个NUGET_EXE变量，直接使用指定版本执行操作。你可以在构建日志里验证这一点——查看NuGet工具安装器的日志，会看到类似Setting NUGET_EXE to C:\dev\tfs_bld_agents\scully\_work\_tool\NuGet\4.3.0\nuget.exe的记录，后续任务的日志也会显示实际使用的版本路径。
• ** fallback到默认版本的情况**：如果某个构建任务没有依赖NuGet工具安装器的输出，或者你手动指定了其他NuGet路径，任务会使用你指定的版本；如果既没有指定也没有环境变量，才会 fallback到代理自带的默认NuGet版本。

额外小提示 #

如果你想清理代理里不用的旧NuGet版本，可以手动删除_work\_tool\NuGet下对应的版本文件夹；不过TFS 2018的代理缓存默认不会自动清理，需要你手动维护。

内容的提问来源于stack exchange，提问作者Morné Kruger