如何使用 Closure Compiler/JSDoc 注释类？

【问题标题】：How to annotate classes with Closure Compiler/JSDoc?如何使用 Closure Compiler/JSDoc 注释类？
【发布时间】：2013-08-13 02:03:52
【问题描述】：

我似乎无法注释一个类，以便 WebStorm 编辑器知道它的方法。

示例如下：

/**
 * @class my class
 * @constructor
 */
function MyClass() {
    this.aPublicField = "foo"
    var aPrivateField = "bar"

    this.aPublicMethod = function() {}
    var aPrivateMethod = function() {}
}

/**
 * @param {MyClass} aClass
 */
function doSomething(aClass) {
    aClass.aPublicMethod() <----- "Unresolved function or method"
}

类似 Java 的语法应该是正确的.. 我猜。我在注释中做错了吗？

【问题讨论】：

标签： class annotations google-closure-compiler webstorm jsdoc

【解决方案1】：

在 WebStorm 6.0.2a 和最新的 7 EAP 中，文档似乎是正确的，代码突出显示对我来说很好。我认为您的问题可能与问题WEB-7548 有关。我们认为@class 标签后面的单词是类名，并且属性附加到了错误的类，因此作为一种解决方法，现在您可以将类描述从@class 标签移到某处，或者作为更好的选择，下载最新的 WebStorm 7 EAP。

【讨论】：

WebStorm 7 解决了这个问题。我想这不仅是类，而且类是在一个模块中声明的，该模块作为参数传递给另一个模块......然后在那里使用。不知道为什么，但即使使用moduleName.MyClass（moduleName 和MyClass 都正确链接到它们的对象）也不能解决问题.. WebStorm 7 只需使用MyClass 似乎工作。