咨询：为何模仿.NET类库//注释折叠后显示带//的内容？

嘿，这个问题我之前也琢磨过！其实这里有个很容易被忽略的细节：你看到.NET类库里那种简洁的//注释，并不是真的用普通单行注释写的，而是IDE对标准XML注释的特殊渲染效果。

为什么官方类库的注释折叠后只显示...？ #

.NET官方类库的公共API文档，本质上全都是用标准的/// XML注释编写的，比如这样：

/// <summary>
/// 初始化一个新的字符串实例
/// </summary>
/// <param name="value">用于初始化字符串的字符数组</param>
public string(char[] value)
{
    // 内部实现逻辑
}

当你通过Visual Studio的「转到定义」查看编译后的类库时，IDE会自动把这些结构化的XML注释转换成更清爽的//样式展示，并且折叠后只保留...——这是IDE为了提升可读性做的友好优化，跟注释本身的写法无关。

为什么自己写的//注释折叠后会显示//...？ #

你手动写的普通//注释就是纯文本注释，没有任何语义标记，IDE不会对它做特殊处理。折叠时自然会保留注释的前缀//，再加上省略号，就变成了//...。

怎么实现类似官方库的简洁折叠效果？ #

• 老老实实用标准的/// XML注释就够了：在Visual Studio中，XML注释折叠后会显示成///...，如果你把自己的代码编译成类库，用反编译工具（比如JetBrains dotPeek）查看时，也会看到和官方库一致的简洁//样式。
• 别费劲用普通//去模拟：目前主流IDE（VS、Rider）都没有针对普通单行注释的特殊折叠渲染功能，因为这类注释没有语义信息，IDE不会专门处理它的显示格式。

不信的话，你可以去看dotnet官方仓库的源代码，所有公共API的注释全都是/// XML注释，这就能实锤上面的说法啦。

内容的提问来源于stack exchange，提问作者Himanshu1983