Source Generator项目可通过dotnet build编译但Visual Studio编译失败

问题核心 #

通过dotnet build可正常编译项目，但在Visual Studio执行Clean Solution后编译报错，根源是Source Generator项目的依赖未被正确复制到输出目录，导致Roslyn无法加载生成器，进而引发部分方法未实现的错误（生成器未生成对应代码）。

解决方案 #

1. 调整Source Generator项目的目标框架 #

将SourceGenerators项目的目标框架从netstandard2.1改为netstandard2.0。Roslyn分析器/生成器对netstandard2.0的兼容性更好，可避免因环境缺失netstandard2.1运行时导致的加载失败。

修改SourceGenerators.csproj中的TargetFramework节点：

<TargetFramework>netstandard2.0</TargetFramework>

2. 添加分析器规则强制执行属性 #

按照警告RS1036的提示，在SourceGenerators项目的PropertyGroup中添加以下配置，确保分析器相关规则被正确应用：

<EnforceExtendedAnalyzerRules>true</EnforceExtendedAnalyzerRules>

3. 强制复制依赖到输出目录 #

在SourceGenerators项目的PropertyGroup中添加CopyLocalLockFileAssemblies，确保所有依赖的DLL被复制到输出目录，避免Roslyn加载生成器时找不到依赖：

<CopyLocalLockFileAssemblies>true</CopyLocalLockFileAssemblies>

4. 修正生成器项目的引用配置 #

确保ClassLibrary1对SourceGenerators的引用设置正确，让Visual Studio识别它是一个Source Generator：
修改ClassLibrary1.csproj中的ProjectReference节点：

<ProjectReference Include="..\SourceGenerators\SourceGenerators.csproj">
  <PrivateAssets>all</PrivateAssets>
  <OutputItemType>Analyzer</OutputItemType>
  <ReferenceOutputAssembly>false</ReferenceOutputAssembly>
</ProjectReference>

原因说明 #

dotnet build和Visual Studio的MSBuild在处理分析器依赖时存在行为差异：

• dotnet build可能隐式处理了依赖复制，而Clean后VS的编译环境没有缓存依赖，导致生成器无法加载。
• 目标框架选择netstandard2.1可能在VS的Roslyn宿主环境中缺少对应的运行时支持，切换到netstandard2.0能解决大部分兼容性问题。

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