C# Source Generator本地正常但在Azure DevOps流水线中失效求助

1. 核对构建配置差异 #

本地一般用Debug模式构建，流水线默认多为Release模式，重点检查：

• 目标项目的Release配置里是否存在<EnableSourceGeneration>false</EnableSourceGeneration>这类禁用源生成的设置
• 确认<Optimize>true</Optimize>等编译优化选项没有导致生成器输出被错误忽略

2. 验证源生成器的分析器输出是否被正确打包 #

源生成器作为Analyzer必须嵌入到目标项目输出中，排查：

• 检查DotNetCoreCLI@2任务是否用了--no-build参数跳过构建，导致源生成器未重新生成
• 查看构建后的输出目录，确认analyzers/dotnet/cs下存在源生成器的DLL文件
• 确保ProjectReference的OutputItemType="Analyzer"和ReferenceOutputAssembly="false"配置没有被条件编译覆盖

3. 统一.NET SDK与依赖版本 #

• 用UseDotNet@2任务指定流水线使用与本地一致的.NET SDK版本（比如适配net6.0的6.x系列），避免SDK版本差异导致Roslyn兼容性问题
• 源生成器依赖的Microsoft.CodeAnalysis包版本（4.11.0）需与SDK自带的Roslyn版本匹配，低版本SDK可能无法加载高版本分析器

4. 开启详细日志定位错误 #

在流水线中添加日志参数，捕获源生成器的运行细节：

• 给DotNetCoreCLI@2任务加上/v:detailed参数，查看MSBuild日志中是否有源生成器加载失败、代码生成错误的信息
• 设置环境变量RoslynDiagnostics=1或添加MSBuild参数/p:RoslynDiagnostics=true，获取Roslyn的诊断日志，确认生成器是否执行

5. 检查分部类的有效性 #

• 确认TaxFilePropertyMapping分部类没有被条件编译排除（比如#if DEBUG导致Release模式下定义不生效）
• 核对分部类的命名空间、访问修饰符与生成器输出的代码完全一致，避免因不匹配导致代码无法合并

6. 清理构建缓存 #

Azure DevOps的构建缓存可能保留旧生成结果，临时测试：

• 添加DotNetCoreCLI@2任务执行clean命令，清理旧构建产物
• 暂时禁用构建缓存，确认是否是缓存导致生成器未执行

内容的提问来源于stack exchange，提问作者Saf-G