允许未知标签的数组不起作用答案

【问题标题】：array of allowUnknownTags doesnt work允许未知标签的数组不起作用
【发布时间】：2017-11-08 21:40:00
【问题描述】：

我有最新的 JsDoc (3.4.3)，根据 JsDoc 的文档，我添加了未知标签数组，但遇到了未知标签的错误

@foo: 标签不是已知标签。 "allowUnknownTags": [ "foo", "usage", "test" ]

我错过了什么吗？

我应该编写 customTag 插件吗？

【问题讨论】：

【解决方案1】：

allowUnknownTags 采用布尔值，而不是数组。

[...]
"tags": {
    "allowUnknownTags": true,
    "dictionaries": ["jsdoc","closure"]
},
[...]

有关在自定义字典中定义您自己的标签的更多信息，请参阅此问题和答案“create custom tags with jsdoc”*。

*：也许……我真的不知道，但似乎是对的。

【讨论】：

但是 jsdoc 文档说 usejsdoc.org/about-configuring-jsdoc.html "tags.allowUnknownTags 属性会影响 JSDoc 如何处理无法识别的标签。如果您将此选项设置为 false，并且 JSDoc 找到了它无法识别的标签（例如， @foo), JSDoc 记录一个警告。默认情况下，此选项设置为 true。在 JSDoc 3.4.1 及更高版本中，您还可以将此属性设置为 JSDoc 应允许的标记名称数组（例如，["foo ","bar"])。"