Roslyn分析器在dotnet build中无法加载的问题排查

问题原因 #

通过ProjectReference将分析器项目标记为Analyzer引用时，dotnet build默认仅复制分析器自身的DLL到消费项目的加载路径，不会自动同步分析器的依赖组件（如Microsoft.CodeAnalysis系列DLL）。而Visual Studio内部构建时依赖特殊机制处理了依赖传递，因此能正常运行分析器。

解决方案 #

方案1：修改分析器项目，强制同步依赖输出 #

在分析器项目的.csproj中添加以下配置，将Roslyn核心依赖也标记为分析器输出项，确保消费项目构建时能一并复制到加载目录：

<Project Sdk="Microsoft.NET.Sdk">
  <!-- 保留原有配置 -->

  <ItemGroup>
    <!-- 将分析器的核心依赖纳入Analyzer输出 -->
    <Analyzer Include="@(ReferenceCopyLocalPaths)" 
              Condition="'%(ReferenceCopyLocalPaths.NuGetPackageId)' == 'Microsoft.CodeAnalysis' 
                      Or '%(ReferenceCopyLocalPaths.NuGetPackageId)' == 'Microsoft.CodeAnalysis.CSharp' 
                      Or '%(ReferenceCopyLocalPaths.NuGetPackageId)' == 'Microsoft.CodeAnalysis.Analyzers'" />
  </ItemGroup>
</Project>

方案2：将分析器打包为NuGet包引用 #

NuGet包能更完善地处理分析器的依赖传递，避免项目引用的局限性：

1. 在分析器项目的.csproj中添加NuPack配置：

<PropertyGroup>
  <!-- 保留原有配置 -->
  <PackageId>MyCodeAnalysers</PackageId>
  <Version>1.0.0</Version>
  <Authors>YourName</Authors>
  <Description>自定义Roslyn代码分析器</Description>
  <GeneratePackageOnBuild>true</GeneratePackageOnBuild>
</PropertyGroup>

2. 构建分析器项目，生成输出目录下的.nupkg包文件。
3. 消费项目改用PackageReference引用该NuGet包：

<ItemGroup>
  <PackageReference Include="MyCodeAnalysers" Version="1.0.0" PrivateAssets="all" />
</ItemGroup>

方案3：对齐dotnet CLI与Visual Studio的Roslyn版本 #

分析器依赖的Microsoft.CodeAnalysis 4.4.0对应.NET 7 SDK的Roslyn版本，若本地dotnet CLI版本过低会导致兼容性问题：

1. 执行dotnet --version检查当前SDK版本，若低于.NET 7则升级到对应版本。
2. 重新执行dotnet build验证问题是否解决。

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