WebStorm仅生成JSDoc注释，jsdoc命令行工具生成HTML文档；需正确使用/**+Enter、自定义Live Templates、File Templates及严格遵循JSDoc语法。
WebStorm 本身不生成最终的 HTML 文档，它只负责生成符合 JSDoc 规范的代码注释；真正生成可浏览文档的是外部工具 jsdoc 命令行程序。搞混这点，后续所有操作都会卡在“为什么点几下没出网页？”上。
在函数/方法前按 /** + Enter 自动生成 JSDoc 框架
这是最常用、也最可靠的注释生成方式，依赖 WebStorm 对 JS/TS 语法的实时解析：
- 光标必须放在函数声明行的正前方（不能在函数体内，也不能在空行）
- 输入
/**后立刻按Enter，WebStorm 会自动补全@param和@returns（如果函数有返回值） - 若函数参数是解构对象或 rest 参数（如
...args），WebStorm 可能漏掉或写错类型，需手动补@param {Object} options这类描述 - 类方法中，
this不会被识别为参数，@this标签得自己加
用 Live Templates 自定义快捷生成（比如输入 method* + Tab）
默认模板只支持基础结构，要让它真正好用，得手动改变量逻辑：
- 进
Settings → Editor → Live Templates → JavaScript，点+新建模板 - 缩写填
method*，模板正文用$functionName$而不是硬写文字——但注意：$functionName$只在函数内部生效，所以模板必须设为 “Applicable in: Statements” 或 “Everywhere in JavaScript” - 点击
Edit variables，把$functionName$的 Expression 设为methodName()，否则它永远为空 -
@param行建议用 Groovy 脚本动态生成，否则每次都要手动删多出来的占位行
用 File and Code Templates 统一文件头注释
新建 .js 文件时自动生成作者、日期等信息，和 JSDoc 注释是两套机制，但能避免重复劳动：
- 路径：
Settings → Editor → File and Code Templates → Files → JavaScript File - 模板里可用变量：
${USER}、${DATE}、${NAME}（当前文件名），但${TIME}在某些系统上不刷新，建议用${HOUR}:${MINUTE} - 别写
@file，JSDoc 规范里没有这个 tag；想标记文件归属，用@module或直接写自然语言描述 - 如果团队要求包含版本号或 license，这里加最稳妥，因为每次新建都强制带上
运行 jsdoc 命令生成静态 HTML 文档
WebStorm 不内置文档构建能力，这步必须靠命令行完成，且容易因路径或配置失败：
- 先全局安装：
npm install -g jsdoc（或项目局部装：npm install jsdoc --save-dev） - 终端执行：
jsdoc src/**/*.js -d docs，其中src/**/*.js是源码路径，docs是输出目录 - 常见报错
Cannot find module 'jsdoc'：检查是否在正确目录下运行，或用 npx：npx jsdoc src/index.js -d docs - 想支持 ES6+ 语法，需额外加
-c jsdoc.json配置文件，并启用plugins: ["plugins/markdown"]等
最常被忽略的一点：JSDoc 注释里的类型写法（如 {string|number}）必须严格遵循 JSDoc 官方语法，WebStorm 的类型提示用的是 TS/JSDoc 混合规则，但 jsdoc CLI 工具只认纯 JSDoc，写错一个括号就可能导致整个参数块失效。
