停止在 XML 文档注释中自动添加“///”。 （C＃）

Posted 2023-04-12

【中文标题】停止在 XML 文档注释中自动添加“///”。 （C＃）

【英文标题】：Stop auto adding "///" in XML Doc Comments. (C#)

【发布时间】：2020-05-25 20:51:13

【问题描述】：

添加新行时如何阻止 Visual Studio 在 XML 文档 cmets 中自动添加“///”。

对于以下示例，“|”字符代表光标位置。

例如在这一行按回车时：

/// Some comment |

在下一行的开头自动输入“///”：

/// Some comment
/// |

我想要的只是这个：

/// Some comment
|

我该如何做到这一点？

【问题讨论】：

你可以按Shift+Enter

如果误按回车，可以使用Ctrl+Backspace一次性删除///

谢谢你们，但是有没有办法完全消除这种行为？

您可以在工具 -> 选项 -> 文本编辑器 -> C# -> 高级 -> 编辑器帮助中禁用“为 /// 生成 XML 文档 cmets”。不过，这会禁用所有 xmldoc 帮助。

【参考方案1】：

三斜杠模式是调用 VS XML 文档功能集的快捷方式。如果您不想要这种行为，您可以使用更传统的双斜线模式；它不会在新行上产生自动插入。