javascript - 如何避免 JSDoc 在 Node JS 函数中生成全局范围文档？

Question

JSdoc 生成了关于我的 nodejs 模块的文档。

/**
 Do something
*/
function doSomething(param1, param2) {
  // blah blah
  ...
}

module.exports.doSomething = doSomething;

JSDoc 的生成文件在全局范围内生成注释，我有数百个这样的导出函数。

有没有办法让JSDoc生成按模块文件名分组的文档？

Answer 1

在你的文件的顶部，你需要像这样包含一个 jsdoc 注释。如果需要，您还可以将模块命名为其他名称。

/**
 @module FileNameOrCustomModuleName
*/

我不认为你可以在一个文件中有多个 @module 指令。