case-sensitive - jsDoc注释使用的正确大小写是什么？

Question

我最近开始使用jsdoc注释来记录我们的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注释使用的正确大小写是什么？还是没关系？我打算将其用于文档生成以及通过Google Closure运行代码以进行类型检查。

谢谢！

Answer 1

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

从Closure: The Definitive Guide：


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


请参阅MDN：Distinction between string primitives and String objects。