SuperAPI AI 工具集

coding-conventions

编程与开发

查看项目

更新于 10-15 22:34

技能介绍

用途:为所有 .NET 项目统一编码规范,鼓励使用 .NET 8 之后的现代特性(C# 12/13/14、.NET 8/9/10),以提升可读性、可维护性与性能。

主要能力:涵盖命名规则(类型、成员、变量、参数)、代码布局与格式、语言特性使用方针(类型推断、集合、异常处理)、LINQ 与 lambda 最佳实践,以及现代 C# 语法的推荐模式。

核心规则:优先使用最新语言特性,除非需要向后兼容;遵循 Microsoft 官方编码规范;禁止使用下划线前缀字段(如 _field);禁止省略大括号(即使只有一行);注释必须单独成行且前留空行;使用文件作用域命名空间;使用语言关键字(string、int)而非运行时类型;仅在类型明显时使用 var;使用字符串插值、Raw String Literals、对象初始化器、using 语句;捕获具体异常;LINQ 中尽早过滤。

版本特性:C# 12(.NET 8)包括 Primary Constructors、Collection Expressions、Default Lambda Parameters、Alias Any Type;C# 13(.NET 9)包括 Params Collections、New Lock Type、Partial Properties and Indexers、Implicit Index Access、Ref Struct Enhancements;C# 14(.NET 10,2025 年 11 月计划发布)包括 Extension Members、Field-Backed Properties、Null-Conditional Assignment、Implicit Span Conversions。

使用方式:作为技能/规范文档在编写 C#/.NET 代码时参照,配合检查清单在编码前、中、后核对。

适用场景:.NET 项目开发、代码审查、团队风格统一、C# 新特性选型。

限制:资料未提供安装命令、收费信息或具体平台支持细节;部分 C# 14 特性为计划发布内容,实际可用性以官方发布为准。