升级.NET 6.0项目构建：无法配置MSBuild正确查找引用程序集

核心原因 #

.NET 6这类SDK风格项目默认会优先查找引用项目的obj/{Configuration}/{TargetFramework}/ref/目录下的轻量引用程序集（用于增量编译优化），而传统.NET Framework 4.6.1项目默认以输出目录（Binaries）作为引用查找路径，这种行为差异导致了编译报错。

可行解决方案 #

1. 调用MSBuild时直接指定参数 #

在PowerShell任务的MSBuild命令中添加以下参数，强制禁用引用程序集生成并指定查找路径：

msbuild YourProject.csproj /p:GenerateReferenceAssembly=false /p:ReferencePath=你的Build_Binaries目录绝对路径

• GenerateReferenceAssembly=false：关闭引用程序集生成，让MSBuild直接使用项目输出的完整程序集
• ReferencePath：显式指定MSBuild查找引用程序集的根目录为你的Build Binaries文件夹

2. 全局配置Directory.Build.props #

若需统一管控所有.NET 6项目，在解决方案根目录创建Directory.Build.props文件，写入以下配置：

<Project>
  <PropertyGroup>
    <!-- 全局禁用引用程序集生成 -->
    <GenerateReferenceAssembly>false</GenerateReferenceAssembly>
    <!-- 将Build Binaries目录加入引用查找路径最前端 -->
    <AssemblySearchPaths>你的Build_Binaries目录绝对路径;$(AssemblySearchPaths)</AssemblySearchPaths>
  </PropertyGroup>
</Project>

随后在MSBuild调用时确保传入正确的路径参数（若使用相对路径需结合构建上下文调整）：

msbuild YourSolution.sln /p:Configuration=Debug

3. 统一所有项目的输出目录 #

将.NET 6和4.6.1项目的输出目录统一指向Build Binaries，消除路径差异：
在Directory.Build.props中添加：

<Project>
  <PropertyGroup>
    <OutputPath>你的Build_Binaries目录绝对路径\$(Configuration)</OutputPath>
    <!-- 可选：移除TargetFramework后缀，让不同框架的输出目录更统一 -->
    <AppendTargetFrameworkToOutputPath>false</AppendTargetFrameworkToOutputPath>
  </PropertyGroup>
</Project>

验证要点 #

• 查看Azure Pipeline的MSBuild日志，确认引用程序集的加载路径为Build Binaries目录
• 确认编译过程中不再出现找不到obj/Debug/net6.0/ref/下程序集的错误

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