IntelliJ IDEA中的JSDoc支持

Question

是否有两个IntelliJ支持的JSDoc子集,超集或混合的文档？我使用JSDoc的动机有两方面:

1. 对于开发人员:因此IntelliJ可以提供更好的代码完成,代码检查,错误检查等.
2. 对于运行时效率:使用Closure编译器.

对于上面的#1,对我来说使用IntelliJ支持的JSDoc标记很重要,直到现在解决这个问题主要是试错过程.

Answer 1

根据WebStorm文档中提供的少量信息,看起来IntelliJ IDEA支持整个JSDoc集.文档中唯一的另一个注释是查看内联文档,它只指向JSDoc SourceForge页面.

Answer 2

这有点试验和错误,但我终于能够用它获得不错的结果.我在使用Backbone类似的OO继承工作时遇到了特别麻烦.我最终做的是这样的事情:

/**
 * @class App.Views.ProductView
 * @extends App.Views.TemplateView
 **/
App.Views.ProductView = App.Views.TemplateView.extend(
  /** @lends App.Views.ProductView **/
  {  
      /**
       * @param {string} str
       * @return string[]
       **/
      method: function (str) {
           return [str, str];
     }
  };

当涉及继承时,你必须手动帮助很多.

据我所知,差异是:你必须为@class提供一个名字,否则就会感到困惑.@name似乎不能很好地工作.其余的都不错,有些标签未使用(@event等等).