SDK风格.NET Framework 3.5旧项目执行dotnet pack报MSB3644错误的解决咨询

我之前处理过类似的场景，SDK风格项目针对.NET Framework 3.5打包时确实容易遇到这个“构建正常但打包失败”的坑——明明已经确认安装了3.5开发工具，引用文件夹也存在，但dotnet pack就是找不到引用程序集。核心原因通常是dotnet CLI默认使用的MSBuild上下文和常规构建时的上下文不一致，下面几个方案你可以逐一尝试：

方案1：直接使用Visual Studio的MSBuild执行打包 #

跳过dotnet pack，改用完整的Visual Studio/MSBuild工具链来执行打包任务，这样能确保加载到.NET Framework 3.5的正确引用环境。比如针对Visual Studio 2019 Build Tools，命令如下：

"C:\Program Files (x86)\Microsoft Visual Studio\2019\BuildTools\MSBuild\Current\Bin\MSBuild.exe" MyProject.csproj /t:Pack /p:PackageVersion=1.2.3-build.4 /p:Configuration=Release /p:OutputPath=./upkgs

如果你的构建服务器装的是VS 2022，路径要改成对应的C:\Program Files\Microsoft Visual Studio\2022\BuildTools\MSBuild\Current\Bin\MSBuild.exe。

方案2：在项目文件中显式指定引用程序集路径 #

虽然你确认了引用文件夹存在，但SDK风格项目可能没自动识别到这个路径。在你的csproj文件里添加以下配置，强制指定引用程序集的位置：

<PropertyGroup>
  <!-- 保留原有的TargetFramework配置 -->
  <TargetFramework>net35</TargetFramework>
  <!-- 显式指定3.5引用程序集路径 -->
  <ReferenceAssemblyPaths>$(ProgramFiles(x86))\Reference Assemblies\Microsoft\Framework\.NETFramework\v3.5</ReferenceAssemblyPaths>
</PropertyGroup>

用$(ProgramFiles(x86))宏可以适配不同机器的路径，避免硬编码带来的问题。

方案3：给dotnet pack命令指定MSBuild SDK路径 #

如果坚持要用dotnet pack，可以通过-p:MSBuildSDKsPath参数指定Visual Studio自带的MSBuild SDK路径，确保打包时使用兼容.NET Framework的工具链：

dotnet pack MyProject.csproj -p:PackageVersion=1.2.3-build.4 --no-build --output ./upkgs --configuration=Release -p:MSBuildSDKsPath="C:\Program Files (x86)\Microsoft Visual Studio\2019\BuildTools\MSBuild\Sdks"

同样，根据你的VS版本调整路径即可。

方案4：完善Microsoft.NETFramework.ReferenceAssemblies包引用 #

你已经尝试添加这个包，但可能需要更明确的引用。建议同时添加主包和针对net35的子包，确保引用程序集被正确引入：

<ItemGroup>
  <PackageReference Include="Microsoft.NETFramework.ReferenceAssemblies" Version="1.0.3" PrivateAssets="all" />
  <PackageReference Include="Microsoft.NETFramework.ReferenceAssemblies.net35" Version="1.0.3" PrivateAssets="all" />
</ItemGroup>

PrivateAssets="all"是为了避免这个包被传递依赖到其他项目中。

方案5：去掉--no-build参数重新尝试 #

有时候--no-build会跳过一些必要的环境初始化步骤，导致打包时无法找到引用程序集。可以先去掉这个参数，让dotnet pack自动完成构建+打包：

dotnet pack MyProject.csproj -p:PackageVersion=1.2.3-build.4 --output ./upkgs --configuration=Release

如果这个能成功，再考虑结合dotnet build和dotnet pack --no-build，但要确保构建和打包使用的是相同的上下文环境。

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