SuperAPI AI 工具集

dotnet-csharp-source-generators

通用与其它

查看项目

更新于 10-16 02:33

技能介绍

用途:为在 .NET 中创建和消费 Roslyn 源生成器提供指导。创建侧覆盖 IIncrementalGenerator、语法提供器、语义分析、代码发射模式、诊断报告,以及用 CSharpGeneratorDriver 做测试;消费侧覆盖 [GeneratedRegex]、[LoggerMessage]、System.Text.Json 源生成与 [JsonSerializable]。

主要能力:生成器项目需以 netstandard2.0 为目标并作为分析器分发,推荐使用 IIncrementalGenerator 而非旧版 ISourceGenerator;管道设计强调尽早过滤、在 transform 中只提取简单数据、使用值相等类型、输出确定性代码。语法提供器可用 ForAttributeWithMetadataName 或 CreateSyntaxProvider。诊断通过 SourceProductionContext 报告,而非抛异常。可用 RegisterPostInitializationOutput 输出标记特性等静态源码。测试可用 CSharpGeneratorDriver 在内存中运行并校验输出,也可用 Verify.SourceGenerators 做快照测试。消费内置生成器方面,[GeneratedRegex] 提供编译期正则、零运行时编译开销且兼容 AOT;[LoggerMessage] 提供高性能结构化日志;System.Text.Json 源生成消除运行时反射,是 Native AOT 所必需,并支持 [JsonDerivedType] 多态。

使用方式:生成器项目设置 TargetFramework 为 netstandard2.0、EnforceExtendedAnalyzerRules 与 IsRoslynComponent 为 true,并引用 Microsoft.CodeAnalysis.Analyzers 与 Microsoft.CodeAnalysis.CSharp(PrivateAssets=all)。消费项目通过 ProjectReference 加 OutputItemType="Analyzer"、ReferenceOutputAssembly="false" 引用生成器。

适用场景与限制:适用于需要编译期代码生成、AOT 兼容序列化与高性能日志的 .NET 项目。范围不含 Roslyn 分析器与代码修复、现代 C# 语言特性、命名约定,这些由其他技能覆盖。资料未提供具体收费、价格与平台信息。