取消

.NET 三个字母究竟应该如何大小写?前面的 “.” 什么时候能够去掉?(.NET Standard / dotnet-core / net472)

本文将解释在 .NET 技术栈中各种不同使用方式下 N E T 三个字母何时大写何时小写;前面的 “.” 什么时候加上,什么时候去掉,什么时候又使用 “dot”。


.NET 在技术文档中

如果你阅读过 https://docs.microsoft.com/zh-cn/dotnet/ 中的多数 .NET 技术文档,你应该几乎已经注意到了,在所有对大小写敏感的地方,NET 三个字母都是大写的。

“.NET” 是 .NET 技术栈名称的最官方写法了,如果能写出 “.NET” 且不会产生其他问题的地方,都应该使用 “.NET”。

.NET 文档标题
▲ 首先映入眼帘的,便是 .NET 技术栈中的所有文档标题

.NET 在代码中

.NET 在代码中并不符合 PascalCase 对命名规范的大小写建议。一般来说三个字母无论是单个单词还是多个单词的缩写,在 PascalCase 中都应该是首字母大写,其后全部小写。但在微软的代码中,NET 依然都是全大写的。

例如 Microsoft.NET.Sdk,去 dotnet/sdk - GitHub 上看,写法都是 NET 全大写的。

.NET 在标识符中

其实,我这里想说的标识符并不是指类名或方法名,那是上一节 .NET 在代码中 所说的内容。这里想说的是,当 .NET 作为用于识别 .NET 某种特征所用的标识符。一般这种标识符有一些命名限制(例如 “.” 开头经常就不符合限制)。

通常作为这种类型的标识符是大小写不敏感的,于是,微软在文档中对此的惯用写法是全部小写

例如,在 Url 中:

前面的 “.” 被改写成了 “dot”。

例如,在项目的目标框架中作为标识符使用时:

  • netstandard2.0
  • netcoreapp2.1
  • net472

这时,连前面的 “.” 都直接去掉了。

.NET 在文件系统中

在文件系统中,“.” 作为前缀的文件或文件夹在 OSX 和 Linux 上都是有特殊用途的,代表隐藏文件夹。这意味着如果没有特别的安排,尽量不要为常规文件夹使用 “.” 作为前缀。

这就意味着,如果你想建一个 .NET 文件夹,你应该去掉前面的 “.”。可是去掉之后的辨识度就太低了,看不出来是 .NET 技术栈。那么怎么命名呢?

这里给一些建议:

  • dotNET 适用于有大小写规范的命名中(例如为了跟 Windows/Android/iOS/OSX 这样的名称保持统一)
  • dotnet 适用于作为普通标识符的命名中(例如为了跟 windows/android/ios/osx 这样的名称保持统一)
  • net 适用于使用缩写的命名中(例如为了跟 win/android/ios/osx 这样的名称保持统一)

.NET 作为产品或机构名称的一部分

JetBrains 家的 .NET 团队很喜欢用 dot 作为软件名称的前缀,例如 dotCover、dotMemory、dotPeek、dotTrace。去 JetBrains: Developer Tools for Professionals and Teams 看看很快就能找到这几款软件的名称。

.NET Core 开源峰会使用 dnc 这样奇怪的缩写,代表 dotnet-core。

总结

合理的 .NET 写法有这些:

  • .NET 推荐
  • NET
  • dotNET
  • dotnet
  • net

如果与其他相关技术名词进行组合:

  • .NET Core
  • ML.NET
  • Microsoft.NET.Sdk
  • dotnet-standard
  • net472

本文会经常更新,请阅读原文: https://blog.walterlv.com/post/case-of-dotnet-writing.html ,以避免陈旧错误知识的误导,同时有更好的阅读体验。

知识共享许可协议

本作品采用 知识共享署名-非商业性使用-相同方式共享 4.0 国际许可协议 进行许可。欢迎转载、使用、重新发布,但务必保留文章署名 吕毅 (包含链接: https://blog.walterlv.com ),不得用于商业目的,基于本文修改后的作品务必以相同的许可发布。如有任何疑问,请 与我联系 ([email protected])

登录 GitHub 账号进行评论