使用PackageVersion属性构建时MSBuild未更新NuGet引用的问题

我之前也碰到过类似的困扰，核心原因是：当你通过命令行传递PackageVersion参数时，MSBuild默认的项目引用依赖版本计算逻辑，可能没有正确读取到所有项目的动态版本值，导致A项目依然沿用了B项目之前缓存的旧版本号。下面是几个经过验证的解决办法：

1. 用Directory.Build.props统一管理版本（推荐） #

在解决方案根目录创建Directory.Build.props文件，把版本属性统一放在这里，这样命令行传入的PackageVersion会自动覆盖所有项目的版本设置：

<Project>
  <PropertyGroup>
    <!-- 默认版本，命令行参数会覆盖这个值 -->
    <PackageVersion>1.0.0</PackageVersion>
    <!-- 如果用Version属性的话也可以一起绑定 -->
    <Version>$(PackageVersion)</Version>
  </PropertyGroup>
</Project>

之后运行构建命令：

msbuild /p:PackageVersion="3.0.0"

所有项目的版本都会同步为3.0.0，A包的依赖项也会自动更新为B 3.0.0。

2. 显式在A项目中绑定B的依赖版本为动态参数 #

修改A项目的.csproj文件，在项目引用节点中显式指定版本为$(PackageVersion)，强制依赖版本跟随命令行传入的参数：

<ItemGroup>
  <ProjectReference Include="..\B\B.csproj">
    <Private>True</Private>
    <!-- 显式设置依赖版本为当前PackageVersion -->
    <Version>$(PackageVersion)</Version>
  </ProjectReference>
</ItemGroup>

这样不管B项目本身的版本设置如何，A包的依赖版本都会直接使用命令行传入的PackageVersion值。

3. 使用中央包管理（Central Package Management） #

如果你的项目是.NET 6+，可以用CPM来统一管理所有包版本，包括项目引用的依赖：

1. 在解决方案根目录创建Directory.Packages.props文件：

<Project>
  <PropertyGroup>
    <ManagePackageVersionsCentrally>true</ManagePackageVersionsCentrally>
  </PropertyGroup>
  <!-- 绑定B的版本为动态PackageVersion -->
  <PackageVersion Include="B" Version="$(PackageVersion)" />
</Project>

2. 修改A项目的.csproj，用包引用的方式代替项目引用（或者保持项目引用，CPM会自动关联版本）：

<ItemGroup>
  <PackageReference Include="B" />
</ItemGroup>

之后构建时，命令行传入的PackageVersion会自动同步到B的版本和A的依赖版本。

额外注意事项 #

• 构建前建议清理项目的obj和bin文件夹，避免旧版本缓存影响结果：

msbuild /t:Clean /p:PackageVersion="3.0.0"
msbuild /t:Restore,Pack /p:PackageVersion="3.0.0"

• 确保所有项目的.csproj中没有硬编码的PackageVersion或Version值，否则会覆盖命令行传入的参数。

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