PhpStorm/WebStorm 中的 CoffeeScript JSDoc 支持答案

【问题标题】：CoffeeScript JSDoc support in PhpStorm/WebStormPhpStorm/WebStorm 中的 CoffeeScript JSDoc 支持
【发布时间】：2013-08-07 15:35:58
【问题描述】：

在 PhpStorm/WebStorm 中工作时，有没有办法使用 JSDoc 来注释用 CoffeeScript 编写的源代码？在 IDE 中工作时，能够使用 JSDoc 对函数进行适当的代码完成是非常有帮助的。

我发现了这个过去的问题：How to document CoffeeScript source code with JSDoc? 但是，答案和 cmets 并不清楚它是否受支持或正确的语法是什么。

【问题讨论】：

标签： coffeescript phpstorm webstorm jsdoc

【解决方案1】：

对于以后遇到此线程的任何人，这是一个更新的答案。 WebStorm 2017.3（撰写本文时的当前版本）支持 CoffeeScript javadocs。

基本语法是这样的：

###*
 * Here is a simple description for foo
 * @param {Bar} bar - Some parameter to foo
 * @returns {Object} The thing that foo returns
###
foo = (bar) ->

当你按下 ctrl+Q 时，WebStorm 会给你文档。

【讨论】：

【解决方案2】：

在coffeescript中，有一种方法可以通过在“`”之间包含代码来使用基本的javascript

咖啡代码 `常见的javascript代码` 咖啡代码

也许可以用它把你的jsCode放在这里

咖啡代码 ` /** @构造函数*/ ` 咖啡代码

我还没有尝试过那个解决方案...

【讨论】：

【解决方案3】：

很遗憾，目前不支持此功能。请随时向youtrack提出此功能的请求

【讨论】：