Source Generator 与 Native AOT：零反射编译期代码生成

在云原生容器与 Serverless 时代，传统依赖运行时反射（Reflection）的框架面临冷启动慢、内存占用高与 AOT 裁剪不兼容等痛点。 BitzOrcas.Modern 坚决确立了 “Source Generator First” 架构红线：所有元数据解析与胶水代码全部交由 Roslyn 增量代码生成器在编译期完成。

编译期 Roslyn 增量生成全景图

三大核心 Roslyn 增量生成器

1. Minimal API 端点生成器（EndpointGenerator）

自动扫描标注了 [GenerateEndpoint] 的 Command/Query 契约，在编译期产出静态端点绑定代码：

// 1. 由 EndpointGenerator 在编译期自动生成的 Minimal API 路由映射扩展方法
// 2. 静态分派至 Mediator 管道，原生免疫 Native AOT 属性与反射裁剪
public static void MapGeneratedEndpoints(this IEndpointRouteBuilder app)
{
    app.MapPost("api/legal/matters", async (
        CreateMatterIntakeCommand command,
        IMediator mediator,
        CancellationToken ct) =>
    {
        var result = await mediator.Send(command, ct);
        return result.ToHttpResult();
    })
    .RequireAuthorization("Legal.Matters.Create");
}

2. 双 ORM Fluent 静态映射生成器（FluentMappingGenerator）

自动读取聚合根上的 [BitzTable] 与 [BitzColumn] 特性，直接输出 EF Core IEntityTypeConfiguration<T> 与 SqlSugar 实体描述符：

• 彻底废弃运行时 modelBuilder.ApplyConfigurationsFromAssembly 反射扫描；
• 静态注册表结构与字段元数据，完全免疫 AOT 属性裁剪。

3. JSON 序列化上下文生成器（JsonContextGenerator）

自动为所有入站请求与出站 DTO 生成强类型 JsonSerializerContext，杜绝 System.Text.Json 在运行时利用反射生成 IL 发射代码。

Native AOT 编译与性能收益

总结

通过 Roslyn 增量生成器与 Native AOT，BitzOrcas.Modern 实现了极致的工程效率与云原生性能的完美融合。