.NET 8中如何基于当前构建用TFS变更集自动更新版本号？

核心思路 #

要解决旧构建版本号错误的问题，关键是获取当前构建任务对应的变更集号，而非仓库的最新变更集。TFS（Azure DevOps Server）构建管道内置了与当前构建绑定的变量，直接使用这些变量就能避免取错变更集的问题。

方案一：通过构建管道变量覆盖版本号 #

这是最灵活的方式，无需修改项目文件，完全在构建管道中配置：

• 打开TFS构建管道的「变量」选项卡，新增变量BuildVersionPrefix，值设置为1.0.0.$(Build.SourceVersion)
• 在构建任务的「MSBuild参数」中添加：/p:VersionPrefix=$(BuildVersionPrefix)
• 保存管道后，每次构建时MSBuild会自动用当前构建对应的变更集号替换版本号最后一位，旧构建重新触发时也会使用当时的变更集号。

方案二：直接在csproj中动态设置版本号 #

如果希望项目文件本身具备适配构建环境的能力，可以修改csproj文件：

<PropertyGroup>
  <!-- 本地开发时使用默认版本号 -->
  <VersionPrefix Condition=" '$(Build.SourceVersion)' == '' ">1.0.0.1</VersionPrefix>
  <!-- TFS构建时自动替换为当前变更集号 -->
  <VersionPrefix Condition=" '$(Build.SourceVersion)' != '' ">1.0.0.$(Build.SourceVersion)</VersionPrefix>
</PropertyGroup>

• $(Build.SourceVersion)是TFS构建环境的内置变量，TFVC仓库下它就是当前构建对应的变更集数字ID，完全符合你需要的格式。
• 本地编译时因为没有这个变量，会使用默认的1.0.0.1，不影响开发流程。

关键说明 #

之前你看到的方案出错，是因为它们用脚本查询仓库最新变更集，而非绑定当前构建的变更集。上述两种方案均使用TFS构建内置的Build.SourceVersion变量，该变量与当前构建任务强绑定，无论触发的是新构建还是旧版本的重新构建，都会返回对应那次提交的变更集号，彻底解决旧构建版本号错误的问题。

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