Roslyn C#分析器升级Microsoft.CodeAnalysis.CSharp包问题咨询

问题根因 #

你遇到的NU1605报错只是传递依赖版本不匹配的表层提示：

error NU1605: Detected package downgrade: Microsoft.CodeAnalysis.Analyzers from 3.3.3 to 2.9.8. Reference the package directly from the project to select a different version.

升级包后编译通过但分析器不运行，本质是Roslyn版本加载冲突：
4.x版本的Roslyn程序集仅随VS2022（17.0+）、.NET 6+ SDK分发，旧版本宿主（VS2019、.NET 5及以下SDK）自带的是3.x版本Roslyn。如果没有显式标记分析器的依赖版本规则，宿主会默认加载自带的3.x版本程序集，无法识别4.2.0中新增的RecordDeclarationSyntax等类型，直接导致分析器加载失败、静默不执行，和Microsoft.CodeAnalysis.Analyzers包的版本没有直接关系。

操作步骤 #

• 对齐所有Roslyn相关包的版本，禁止混版本引用
  除了Microsoft.CodeAnalysis.CSharp升级到4.2.0，必须显式引用同版本的Microsoft.CodeAnalysis.Common，不要依赖传递拉取的版本。Microsoft.CodeAnalysis.Analyzers对应4.2.0的匹配版本是3.3.4，不是3.3.3，小版本不匹配也会触发隐式加载异常。所有包引用添加PrivateAssets="all"配置，避免把依赖打包进分析器NuGet包造成二次冲突，示例配置：

  <PackageReference Include="Microsoft.CodeAnalysis.CSharp" Version="4.2.0" PrivateAssets="all" />
  <PackageReference Include="Microsoft.CodeAnalysis.Common" Version="4.2.0" PrivateAssets="all" />
  <PackageReference Include="Microsoft.CodeAnalysis.Analyzers" Version="3.3.4" PrivateAssets="all" />
  

• 调整项目配置，禁用隐式版本拉取
  在分析器项目的csproj文件的PropertyGroup节点下添加如下配置，避免SDK自动引用旧版本Roslyn依赖：

  <PropertyGroup>
    <TargetFramework>netstandard2.0</TargetFramework>
    <EnforceExtendedAnalyzerRules>true</EnforceExtendedAnalyzerRules>
    <DisableImplicitlyFrameworkReferences>true</DisableImplicitlyFrameworkReferences>
    <!-- 标记分析器要求的最低Roslyn宿主版本 -->
    <SupportedRoslynVersion>4.2.0</SupportedRoslynVersion>
  </PropertyGroup>
  

• 修正打包/部署配置
  如果将分析器打包为NuGet包或VSIX插件，必须在包清单中标记最低支持的Roslyn版本为4.2.0，明确告知宿主不要用低于该版本的Roslyn程序集加载分析器。如果是本地调试，直接用VS2022作为调试宿主，不要用VS2019及以下版本。
• 兼容低版本宿主的可选方案
  如果需要同时兼容VS2019（Roslyn 3.x）环境，不要硬依赖4.2.0版本的强类型RecordDeclarationSyntax：Roslyn 3.3.1版本已经包含SyntaxKind.RecordDeclaration枚举值，可以在语法节点行动中通过Kind判断匹配record节点，通过SyntaxNode的通用API解析节点信息，不需要升级包即可实现record类型的分析逻辑。如果一定要用4.x的新增API，可采用多目标框架编译，分别编译适配3.x、4.x版本的两个分析器程序集，在NuGet包中按宿主版本分发对应文件。

验证方法 #

部署分析器后，打开VS2022的输出窗口，将日志源切换为分析器，即可查看分析器的加载日志，如果存在程序集加载错误会直接显示具体冲突的版本信息，方便定位问题。

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