用于 jsDoc 注释的正确大小写是什么？

Question

我最近开始使用 jsdoc cmets 来记录我们的 javascript 代码，但是我发现使用 @param 标记的示例相互冲突。

见https://code.google.com/p/jsdoc-toolkit/wiki/TagParam（PascalCase）

和https://developers.google.com/closure/compiler/docs/js-for-compiler（驼色/小写）。

camelCase 对我来说很有意义，因为：

var foo = 1;
console.log(typeof foo); // outputs "number"

jsDoc @param cmets 使用的正确大小写是什么？还是没关系？我打算将它用于文档生成以及通过 google 闭包运行代码以进行类型检查。

谢谢！

Answer 1

JSDoc 类型表达式的冲突示例涉及 JavaScript 原始类型 string、number 和 boolean，它们具有相应的包装器类型：String、Number 和 Boolean。

来自Closure: The Definitive Guide：

Closure Library 中禁止使用包装器类型，因为 如果使用包装器类型，某些函数可能无法正常运行 需要原始类型的地方。

参见 MDN：Distinction between string primitives and String objects。