webstorm仅生成jsdoc注释框架而不生成html文档，真正生成index.html需通过命令行工具jsdoc执行；光标须置于函数声明行最左侧输入/**+enter才能自动补全，箭头函数需转换形式，解构与rest参数需手动补全@param，@this需手写，jsdoc命令需正确安装与路径配置，live templates中$functionname$需设为methodname()，@param类型必须用大括号包裹。
WebStorm不生成HTML文档，只生成注释框架
WebStorm 本身不会输出网页版文档，它只负责在代码里插入符合 JSDoc 规范的注释块。真正生成 index.html 的是外部命令行工具 jsdoc。如果在 WebStorm 里点几下没看到网页，不是操作错了，而是还没走完第二步。
光标放对位置才能触发 /** + Enter
这是最常用也最容易失败的环节：光标必须紧贴函数/类/方法声明行的最左侧（比如 function calculate() 这一行开头，光标在 f 前），输入 /** 后立刻按 Enter，WebStorm 才会自动补全 @param 和 @returns。
- 箭头函数（
const fn = (a) => {}）不被识别，得先转成function形式，或用Ctrl+Shift+A搜Fix Doc Comment - 解构参数（如
({ id, name })）和 rest 参数（...args）常被漏掉，@param行需手动补全类型和说明 - 类方法里的
this不会自动生成@this，必须手写
jsdoc 命令行生成静态文档
装好 jsdoc 后，在终端执行命令才是出网页的关键：
- 全局安装：
npm install -g jsdoc；局部安装：npm install jsdoc --save-dev - 基本命令：
jsdoc src/**/*.js -d docs（src/**/*.js是源码路径，docs是输出目录） - 常见报错
Cannot find module 'jsdoc'：检查是否在项目根目录运行，或确认node_modules/.bin是否在$PATH中 - 想换主题（比如
docdash）：先npm install docdash，再加参数-t node_modules/docdash
Live Templates 自定义 method* 时容易翻车
想用 method* + Tab 快速生成，得调两个关键设置，否则 $functionName$ 总是空的：
- 进
Settings → Editor → Live Templates → JavaScript，新建模板，缩写填method* - 点击
Edit variables，把$functionName$的 Expression 改成methodName() - 适用范围选
Statements或Everywhere in JavaScript，不能只选Function declaration -
@param行别硬写固定数量，否则多参数时要手动删占位符；建议用 Groovy 脚本动态生成
注释一旦生成，就参与类型推导——@param {string} 写成 string（缺大括号），后续调用处的类型提示就会失效，比不写还危险。
