SuperAPI AI 工具集

dotnet-csharp-modern-patterns

通用与其它

查看项目

更新于 10-16 02:33

技能介绍

用途:为 .NET 项目提供现代 C# 语言特性的采用指导,并根据项目的目标框架(TFM)确定可用的 C# 版本与特性。使用前应先运行 [skill:dotnet-version-detection] 确定 TFM 和 C# 版本。

主要能力:覆盖记录(record class/struct、with 非破坏性变更)、模式匹配(switch 表达式、列表模式、类型与属性模式)、主构造函数、集合表达式、required 成员、field 关键字、扩展块、类型别名、params 集合、Lock 类型、分部属性、未绑定泛型的 nameof 等。资料给出 TFM 到 C# 版本的对照:net8.0 对应 C# 12,net9.0 对应 C# 13,net10.0 对应 C# 14,net11.0 对应 C# 15(预览)。

使用方式:按目标框架选用特性;net11.0 的集合表达式 with() 参数需 <LangVersion>preview</LangVersion>,且不可用于更早 TFM。多目标时可用 PolySharp 补齐编译器所需类型、Polyfill 补齐运行时 API,无法 polyfill 的特性用 #if NET10_0_OR_GREATER 等条件编译。

适用场景:DTO、值对象、领域建模、DI 服务、日志与诊断等。

限制:主构造函数参数是可变的捕获而非只读字段,需要不可变时应显式赋给 readonly 字段;需要构造时校验参数时应用传统构造函数。命名与风格、async/await、源生成器分别参见其他技能,不在本技能范围内。部分特性仅限特定 TFM,需注意兼容性。