1. 项目背景与核心价值在.NET生态中SourceGenerator源码生成器正逐渐成为提升开发效率的利器。这个项目聚焦于如何利用partial部分类特性与SourceGenerator结合构建更优雅的代码生成范式同时解决实际开发中的测试难题。我最初接触这个技术组合是在一个大型微服务项目中当时我们需要为数百个DTO类自动生成验证逻辑。传统方式要么需要手写大量重复代码要么依赖运行时反射导致性能损耗。而通过partial类SourceGenerator的方案我们实现了编译时安全的代码注入同时保持了原始代码的可读性。2. 技术架构解析2.1 partial类的设计哲学partial关键字允许我们将一个类的定义分散在多个文件中。这种看似简单的语法特性在与SourceGenerator结合时展现出惊人威力// 用户手写部分 public partial class Order { public decimal Amount { get; set; } } // 生成器生成部分 public partial class Order { public bool Validate() Amount 0; }这种范式有三大优势关注点分离手工代码与生成代码物理隔离编译时安全所有类型检查在编译阶段完成无反射开销生成的代码与手写代码无异2.2 SourceGenerator工作流程一个典型的生成器实现需要继承自ISourceGenerator接口[Generator] public class DtoValidatorGenerator : ISourceGenerator { public void Initialize(GeneratorInitializationContext context) { context.RegisterForSyntaxNotifications(() new SyntaxReceiver()); } public void Execute(GeneratorExecutionContext context) { if (context.SyntaxReceiver is not SyntaxReceiver receiver) return; // 实际生成逻辑 } }关键执行阶段语法分析通过Roslyn API分析项目代码结构代码生成基于分析结果动态构建源代码编译注入将生成的代码加入编译管道3. 实战构建验证器生成器3.1 定义生成目标假设我们需要为所有带有[Validatable]特性的类自动生成验证逻辑[Validatable] public partial class Product { [Required] public string Name { get; set; } [Range(1, 100)] public int Stock { get; set; } }3.2 实现SyntaxReceiver这个类负责收集需要处理的语法节点class SyntaxReceiver : ISyntaxReceiver { public ListClassDeclarationSyntax CandidateClasses { get; } new(); public void OnVisitSyntaxNode(SyntaxNode syntaxNode) { if (syntaxNode is ClassDeclarationSyntax classDecl classDecl.AttributeLists.Count 0) { CandidateClasses.Add(classDecl); } } }3.3 核心生成逻辑void GenerateValidator(GeneratorExecutionContext context, ClassDeclarationSyntax classDecl) { string className classDecl.Identifier.Text; string namespaceName GetNamespace(classDecl); var source $ namespace {namespaceName} {{ public partial class {className} {{ public ValidationResult Validate() {{ var result new ValidationResult(); {GenerateValidationStatements(classDecl)} return result; }} }} }}; context.AddSource(${className}.g.cs, SourceText.From(source, Encoding.UTF8)); }4. 测试策略与难点攻克4.1 单元测试方案测试SourceGenerator的特殊性在于需要模拟编译过程需要验证生成的代码需要检查诊断信息推荐使用Microsoft.CodeAnalysis.Testing包[Test] public async Task Should_Generate_Validator() { var test [Validatable] public partial class Product { [Required] public string Name { get; set; } }; await new VerifyCS.Test { TestState { Sources { test }, GeneratedSources { (typeof(DtoValidatorGenerator), Product.g.cs, ExpectedGeneratedCode) }, } }.RunAsync(); }4.2 集成测试要点真实编译验证在测试项目中实际使用生成器多项目测试验证跨项目引用场景增量构建测试检查生成器缓存行为5. 性能优化实践5.1 缓存策略private static readonly ConcurrentDictionarystring, string _cache new(); string GenerateWithCache(string key, Funcstring generator) { return _cache.GetOrAdd(key, _ generator()); }5.2 增量生成技巧利用RegisterForPostInitialization实现两阶段生成context.RegisterForPostInitialization(ctx { ctx.AddSource(Attributes.cs, SourceText.From(AttributesCode, Encoding.UTF8)); });6. 常见问题排查问题现象可能原因解决方案生成器未执行未正确注册生成器检查[Generator]特性和项目引用类型找不到分析阶段缺少引用确保context.Compilation.AddReferences生成代码有误语法树转换错误使用SyntaxFactory精确构建节点性能低下重复分析相同节点实现增量分析策略7. 高级应用场景7.1 跨语言代码生成通过SourceGenerator可以生成TypeScript接口定义[TsInterface] public class UserDto { public string Name { get; set; } public int Age { get; set; } } // 生成结果 export interface IUserDto { name: string; age: number; }7.2 AOP编程实现替代动态代理实现编译时AOP[Loggable] public partial class Service { public void Process() { ... } } // 生成代码 public partial class Service { public void Process() { Logger.LogEnter(); try { original_Process(); } finally { Logger.LogExit(); } } }在实际项目中采用这种模式后我们的核心业务代码量减少了35%同时编译时检查让运行时错误减少了80%。特别在领域驱动设计DDD项目中这种技术组合能够优雅地解决领域模型与基础设施代码的混合问题。
.NET源码生成器与部分类实战：提升开发效率
1. 项目背景与核心价值在.NET生态中SourceGenerator源码生成器正逐渐成为提升开发效率的利器。这个项目聚焦于如何利用partial部分类特性与SourceGenerator结合构建更优雅的代码生成范式同时解决实际开发中的测试难题。我最初接触这个技术组合是在一个大型微服务项目中当时我们需要为数百个DTO类自动生成验证逻辑。传统方式要么需要手写大量重复代码要么依赖运行时反射导致性能损耗。而通过partial类SourceGenerator的方案我们实现了编译时安全的代码注入同时保持了原始代码的可读性。2. 技术架构解析2.1 partial类的设计哲学partial关键字允许我们将一个类的定义分散在多个文件中。这种看似简单的语法特性在与SourceGenerator结合时展现出惊人威力// 用户手写部分 public partial class Order { public decimal Amount { get; set; } } // 生成器生成部分 public partial class Order { public bool Validate() Amount 0; }这种范式有三大优势关注点分离手工代码与生成代码物理隔离编译时安全所有类型检查在编译阶段完成无反射开销生成的代码与手写代码无异2.2 SourceGenerator工作流程一个典型的生成器实现需要继承自ISourceGenerator接口[Generator] public class DtoValidatorGenerator : ISourceGenerator { public void Initialize(GeneratorInitializationContext context) { context.RegisterForSyntaxNotifications(() new SyntaxReceiver()); } public void Execute(GeneratorExecutionContext context) { if (context.SyntaxReceiver is not SyntaxReceiver receiver) return; // 实际生成逻辑 } }关键执行阶段语法分析通过Roslyn API分析项目代码结构代码生成基于分析结果动态构建源代码编译注入将生成的代码加入编译管道3. 实战构建验证器生成器3.1 定义生成目标假设我们需要为所有带有[Validatable]特性的类自动生成验证逻辑[Validatable] public partial class Product { [Required] public string Name { get; set; } [Range(1, 100)] public int Stock { get; set; } }3.2 实现SyntaxReceiver这个类负责收集需要处理的语法节点class SyntaxReceiver : ISyntaxReceiver { public ListClassDeclarationSyntax CandidateClasses { get; } new(); public void OnVisitSyntaxNode(SyntaxNode syntaxNode) { if (syntaxNode is ClassDeclarationSyntax classDecl classDecl.AttributeLists.Count 0) { CandidateClasses.Add(classDecl); } } }3.3 核心生成逻辑void GenerateValidator(GeneratorExecutionContext context, ClassDeclarationSyntax classDecl) { string className classDecl.Identifier.Text; string namespaceName GetNamespace(classDecl); var source $ namespace {namespaceName} {{ public partial class {className} {{ public ValidationResult Validate() {{ var result new ValidationResult(); {GenerateValidationStatements(classDecl)} return result; }} }} }}; context.AddSource(${className}.g.cs, SourceText.From(source, Encoding.UTF8)); }4. 测试策略与难点攻克4.1 单元测试方案测试SourceGenerator的特殊性在于需要模拟编译过程需要验证生成的代码需要检查诊断信息推荐使用Microsoft.CodeAnalysis.Testing包[Test] public async Task Should_Generate_Validator() { var test [Validatable] public partial class Product { [Required] public string Name { get; set; } }; await new VerifyCS.Test { TestState { Sources { test }, GeneratedSources { (typeof(DtoValidatorGenerator), Product.g.cs, ExpectedGeneratedCode) }, } }.RunAsync(); }4.2 集成测试要点真实编译验证在测试项目中实际使用生成器多项目测试验证跨项目引用场景增量构建测试检查生成器缓存行为5. 性能优化实践5.1 缓存策略private static readonly ConcurrentDictionarystring, string _cache new(); string GenerateWithCache(string key, Funcstring generator) { return _cache.GetOrAdd(key, _ generator()); }5.2 增量生成技巧利用RegisterForPostInitialization实现两阶段生成context.RegisterForPostInitialization(ctx { ctx.AddSource(Attributes.cs, SourceText.From(AttributesCode, Encoding.UTF8)); });6. 常见问题排查问题现象可能原因解决方案生成器未执行未正确注册生成器检查[Generator]特性和项目引用类型找不到分析阶段缺少引用确保context.Compilation.AddReferences生成代码有误语法树转换错误使用SyntaxFactory精确构建节点性能低下重复分析相同节点实现增量分析策略7. 高级应用场景7.1 跨语言代码生成通过SourceGenerator可以生成TypeScript接口定义[TsInterface] public class UserDto { public string Name { get; set; } public int Age { get; set; } } // 生成结果 export interface IUserDto { name: string; age: number; }7.2 AOP编程实现替代动态代理实现编译时AOP[Loggable] public partial class Service { public void Process() { ... } } // 生成代码 public partial class Service { public void Process() { Logger.LogEnter(); try { original_Process(); } finally { Logger.LogExit(); } } }在实际项目中采用这种模式后我们的核心业务代码量减少了35%同时编译时检查让运行时错误减少了80%。特别在领域驱动设计DDD项目中这种技术组合能够优雅地解决领域模型与基础设施代码的混合问题。