1

我真的很想了解这条规则的意义所在。构造函数“初始化类的新实例”不是很明显吗?

感觉和强制方法摘要说“这是一个方法,它会做某事,返回并可能返回一个值”是一样的

4

1 回答 1

2

IMO,这主要是关于构造函数摘要的一致性,而不是任何特定构造函数摘要的措辞。如果您要求构造函数有摘要但不检查一致的措辞,您最终会得到各种风格的描述。这并不完全是世界末日,但它会惹恼 API 用户。

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

于 2012-07-23T12:32:39.980 回答