.NET // vs /// 注释约定答案

【问题标题】：.NET // vs /// Comments convention.NET // vs /// 注释约定
【发布时间】：2023-03-03 02:21:01
【问题描述】：

我只是检查 F#，如果这是一个愚蠢的问题，请道歉，但在 VS2008 F# CTP 1.9.6.2 'Tutorial' 项目中， // 和 /// 都用于注释代码。

两个斜线与三个斜线注释之间是否存在功能差异，或者是惯例（如教程代码中所示）用 /// 注释函数并使用 // 其他所有内容？

【问题讨论】：

标签： c# f# comments

【解决方案1】：

使用三个斜杠 (///) 是 XML Documentation Comments 的 C# 约定，也被 F# 采用。

【讨论】：

【解决方案2】：

/// C# 和 VB.Net 的 ''' 不仅仅是内部 cmets。如果在项目属性中打开 XML 文档文件，则可以使用 Sandcastle 和 HTML Help 生成四种不同的文档类型（文件和网站）。请参阅 https://github.com/EWSoftware/SHFB/wiki 和 microsoft docs。此外，这可以添加到您的 CI 流程中。

【讨论】：

【解决方案3】：

类似于 Java 中的 /* comment */ 与 /** documented comment */。

后者的工作原理相同，但也被文档软件识别为开发人员文档 - 而不仅仅是注释。

【讨论】：

只有知道这些注释结构在 Java 中的作用时才会有帮助，这不是问题所在。

【解决方案4】：

/// 用于文档 cmets。 VS 在生成智能感知信息时会用到它。

【讨论】：