C#中包含扩展方法的文件命名遵循什么约定?
C#扩展方法文件的命名约定实践
虽然微软官方文档确实没有明确规定扩展方法的文件命名规则,但社区已经形成了一套普遍遵循的实践,能提升代码的可读性和维护性:
- 按扩展目标类型命名:这是最常用的方式,文件名直接体现被扩展的类型,比如给
string类型写扩展就命名为StringExtensions.cs,给IEnumerable<T>写扩展就叫EnumerableExtensions.cs。这种命名让其他开发者一眼就能知道文件里的扩展是针对哪个类型的。 - 按功能领域分组命名:如果扩展方法是服务于特定业务或功能模块的,就按领域命名,比如订单相关的扩展叫
OrderProcessingExtensions.cs,日期处理相关的叫DateUtilityExtensions.cs。 - 拆分大型扩展集合:如果某个类型的扩展方法数量很多,可以按子功能进一步拆分,比如把
string的扩展拆成StringValidationExtensions.cs(验证相关)和StringManipulationExtensions.cs(字符串操作相关)。 - 避免过度宽泛的命名:尽量别用
Extensions.cs这种无差别的名字,除非是项目全局通用的基础扩展集合,否则不利于后续查找和维护。
额外的配套实践:
- 扩展类的命名通常和文件名保持一致,比如
StringExtensions.cs里的静态类就叫StringExtensions; - 扩展类建议放在对应类型的命名空间下,或者专门的
YourProject.Extensions子命名空间中,方便统一管理和引用。
内容的提问来源于stack exchange,提问作者Vinccool96
相关产品推荐
相关产品推荐

