atom不能直接生成jsdoc文档，因其无内置ast解析器，无法识别@param等注释；需用apidoc等cli工具配合严格注释格式（如@param {string} theme）和手动命令执行。
Atom 本身不解析 JSDoc，也不生成文档——它只负责写注释、触发命令、预览结果。想靠点一下就出 HTML 文档？做不到。
为什么 Atom 不能直接生成 JSDoc 文档
Atom 没有内置 AST 解析器，无法读取函数签名、识别 @param 或提取 @returns。像 jsdoc、apidoc 这类工具必须独立运行，Atom 只能当“记事本+快捷入口”。常见错误现象包括：
• 点击插件按钮没反应
• 生成的 HTML 里参数全空
• class 方法被忽略（尤其 ES6 class）
根本原因不是插件坏了，而是你试图让 Atom 做它设计上就不干的事。
用 apidoc 在 Atom 项目里跑通最小可行流程
apidoc 是目前 Atom 配合最顺手的 CLI 工具，但必须手动搭一层胶水：
- 在项目根目录执行
npm install --save-dev apidoc - 注释必须是紧贴函数/类上方的
/** */块，且格式严格：
• 错误写法：/** @param theme {string} */（缺空格、括号位置错）
• 正确写法：@param {string} theme - 执行
npx apidoc -i src/ -o docs/，其中src/是你放 JS 文件的实际路径 - 生成后直接用浏览器打开
docs/index.html，别指望 Atom 内置预览能渲染完整结构
注意：apidoc 不识别 class Editor { initialize() {} } 这种写法，必须加 @name Editor#initialize 手动绑定作用域，否则方法直接消失。
Docblockr 怎么避免注释写错导致文档提取失败
Docblockr 不生成文档，但它能防止你把注释写成废纸：
- 光标停在函数名正上方（整行任意位置），输入
/**+Tab，自动补全@param和@returns - 遇到解构参数如
({ theme, packages })，它不会展开，得手动补：@param {Object} options+@param {string} options.theme - 关掉
Auto-Expand On Enter设置，否则回车会多插*，破坏apidoc解析规则 - Vue 单文件组件中
<script></script>块默认不激活Docblockr，需在设置里把.vue显式映射到source.jsscope
生成文档时最容易被忽略的三个细节
• apidoc 要求注释块和函数声明之间**不能有空行**，哪怕只隔一行，也会断开关联
• jsdoc 对 async 函数支持更好，但需要额外加 @async 标签，否则 {Promise<t>}</t> 可能被当成普通对象
• 所有自定义标签（如 @featureGroup）必须在解析工具启动前注册，Atom 插件本身不参与这一步——你得改 jsdoc.conf.json 或传参指定 --configure
