是什么规则强制执行构造函数摘要说“初始化<whatever>类的新实例”？</whatever>

Question

我真的很想了解这条规则的重点。构造函数“初始化类的新实例”不是很明显吗？

感觉像是强迫方法摘要说“这是一种方法，它会做某事，返回并可能返回一个值”

Answer 1

IMO，这个主要是关于构造函数摘要的一致性，而不是任何特定构造函数摘要的措辞。如果您要求构造函数具有摘要但不检查一致的措辞，则最终会得到各种描述样式。这不是世界末日，但它可以惹恼API用户。

如果您有理由保持规则启用并想要一种简单的方法来生成标准构造函数摘要，您可能需要查看GhostDoc。