为什么 JSDoc 允许同时使用 Array<string> 和 Array.<string>，并且一个比另一个好？

Question

JSDoc 似乎有 2 种不同但相似的语法 参数化类型。第一种语法的示例 是Array.<MyClass>（你可以找到here）。第二个例子是Array<number> （你可以找到here）。 为什么两种语法都支持，而且一种比另一种更好？

Answer 1

没有“更好”或“有价值”的方式来记录您的代码。您看到的是 JSDoc 文档中的不一致。他们有积压项目以使其保持一致：Clean up examples of type applications，其内容如下：

类型应用程序不再需要包含句点。例如，您可以写Array<number> 而不是Array.<number>。我们应该更新所有示例以使用更精简的语法。

在记录Arrays 的对象时，已经有答案：How to specify an array of objects as a parameter or return value in JSDoc?。