NuGet包中无法创建Analyzer实例，求排查及解决方法

可能的原因 #

• 依赖项缺失或不兼容：源生成器项目引用的第三方NuGet包未被正确打包进最终的NuGet包，或者依赖包版本与引用项目环境冲突。比如源生成器使用了特定版本的Microsoft.CodeAnalysis.CSharp，但打包时未将该依赖标记为必要项，导致加载时找不到依赖程序集。
• 目标框架与打包配置冲突：即使切换到netstandard2.0，若项目存在错误配置（如<IncludeBuildOutput>设置异常），或NuGet打包时未将分析器DLL放置在规范目录（analyzers/dotnet/cs），Roslyn无法正确识别并加载源生成器。NU5128警告通常意味着包中包含了不属于目标框架的文件，可能是打包时误包含了其他框架的输出文件。
• 源生成器类的访问性问题：SuperFluid.Internal.SourceGenerators.FluidApiSourceGenerator类必须是public，且实现ISourceGenerator接口、拥有无参构造函数。如果类是internal的，Roslyn无法实例化该类，会抛出调用目标异常。
• 强命名签名问题：若源生成器项目启用了强命名，但打包时签名不完整或引用项目环境无法验证签名，会导致程序集加载失败。
• 输出文件结构错误：NuGet包中分析器的目录结构不符合规范，DLL未放置在analyzers/dotnet/cs下，导致Roslyn无法扫描到并加载。

获取内部异常详细信息的方法 #

• 提升MSBuild日志详细度：在Visual Studio中打开工具 -> 选项 -> 项目和解决方案 -> 构建并运行，将MSBuild项目构建输出详细程度设置为诊断，重新构建引用项目。日志中会包含完整的异常堆栈，包括内部异常的具体信息（如缺失的依赖、反射失败的原因）。
• 临时添加日志捕获：修改源生成器的构造函数或Initialize方法，添加try-catch块，将异常信息写入本地文件（例如Path.Combine(Environment.GetFolderPath(Environment.SpecialFolder.ApplicationData), "sg_error.log")），重新打包后在引用项目中构建，查看日志文件获取详细错误。注意发布时移除该代码。
• 启用Roslyn诊断日志：设置环境变量Roslyn_DiagnosticLogging=true，然后通过dotnet build命令构建引用项目，或重启Visual Studio后构建。Roslyn会生成详细的加载日志，其中包含分析器实例化失败的完整异常信息。

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