自定义MSBuild NuGet包版本异常：文件版本正常但包版本仍为1.0.0

核心问题所在 #

NuGet的PackageVersion属性得在项目评估阶段就确定下来，你把ComputePackageVersion目标放在BeforeBuild前执行，这属于执行阶段，而NuGet打包的核心逻辑早在评估阶段就跑完了，所以你后来计算的版本根本没机会生效。

具体修复步骤 #

1. 把版本计算提前到评估阶段 #

要么把版本计算逻辑直接写到Directory.Build.props里，要么在Directory.Build.targets里用InitialTargets让目标提前执行，确保在项目评估完成后立刻算出版本：

<!-- Directory.Build.targets 示例配置 -->
<Project>
  <PropertyGroup>
    <!-- 指定初始目标，强制先执行版本计算 -->
    <InitialTargets>ComputePackageVersion</InitialTargets>
  </PropertyGroup>

  <Target Name="ComputePackageVersion">
    <PropertyGroup>
      <!-- 替换成你的版本定义和计算逻辑 -->
      <Major>1</Major>
      <Minor>0</Minor>
      <BuildNumber>$(Build.BuildNumber)</BuildNumber>
      <RevisionNumber>$([System.DateTime]::Now.ToString("HHmm"))</RevisionNumber>
      <Version>$(Major).$(Minor).$(BuildNumber).$(RevisionNumber)</Version>
      <PackageVersion>$(Version)</PackageVersion>
    </PropertyGroup>
  </Target>
</Project>

2. 清理项目文件里的硬编码版本 #

检查你的.csproj/.vbproj文件，要是里面显式写了Version或PackageVersion，会直接覆盖Directory.Build里的配置，必须删掉：

<!-- 项目文件里要删掉这些硬编码的行 -->
<!-- <Version>1.0.0</Version> -->
<!-- <PackageVersion>1.0.0</PackageVersion> -->

3. 验证CI变量传递（如果用CI构建） #

要是BuildNumber是从CI变量（比如Azure DevOps的Build.BuildNumber）拿的，得确保变量能传到MSBuild进程里，手动测试可以加参数：

msbuild /t:Pack /p:BuildNumber=20240520 /p:Major=1 /p:Minor=1

4. 确认打包目标的依赖顺序 #

用dotnet pack的话，得保证ComputePackageVersion在Pack目标之前跑，可通过日志验证：

msbuild /t:Pack /v:d | findstr "ComputePackageVersion"

要是日志里看不到这个目标，就给目标加BeforeTargets="Pack"：

<Target Name="ComputePackageVersion" BeforeTargets="Pack">
  <!-- 版本计算逻辑 -->
</Target>

快速验证方法 #

执行打包后，看生成的nupkg文件名，或者直接查属性值：

msbuild /t:GetProperty /p:PropertyName=PackageVersion

输出的是你计算的版本，就说明配置生效了。

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