Javascript 为什么JSDoc同时允许数组<;字符串>;和阵列。<;字符串>;,一个比另一个好吗?

Javascript 为什么JSDoc同时允许数组<;字符串>;和阵列。<;字符串>;,一个比另一个好吗?,javascript,jsdoc,Javascript,Jsdoc,JSDoc似乎有两个不同但相似的语法 参数化类型。第一种语法的示例 是数组。(您可以找到它)。第二个示例是Array (你可以找到)。 为什么两种语法都受支持,而且一种语法比另一种更好?没有“更好”或“值得”的方法来记录代码。您看到的是JSDoc文档中的不一致性。他们有待办事项,以使其一致:,说明如下: 类型应用程序不再需要包含句点。例如,您可以编写数组,而不是数组。。我们应该更新所有示例,以使用更精简的语法 在记录对象的数组时,已经有了关于SO的答案: 你为什么期望一种语法比另一种更好?@Li

JSDoc似乎有两个不同但相似的语法 参数化类型。第一种语法的示例 是
数组。
(您可以找到它)。第二个示例是
Array
(你可以找到)。 为什么两种语法都受支持,而且一种语法比另一种更好?

没有“更好”或“值得”的方法来记录代码。您看到的是JSDoc文档中的不一致性。他们有待办事项,以使其一致:,说明如下:

类型应用程序不再需要包含句点。例如,您可以编写
数组
,而不是
数组。
。我们应该更新所有示例,以使用更精简的语法


在记录对象的数组时,已经有了关于SO的答案:

你为什么期望一种语法比另一种更好?@Li357:我猜一种语法比另一种新,之所以采用这种语法是因为它被认为更好。你引用的文本清楚地表明,最好省略点。这一点在中更为明确,即“
Promise
优于
Promise.
”。无论如何,你已经引导我找到了我问题的答案,所以谢谢你。@StarFlow很高兴它帮助了你。接受回答: