webstorm原生支持在函数/类/方法声明行正前方输入/**后回车生成标准jsdoc框架，自动添加@param和@returns；光标必须紧贴函数名左侧才触发，箭头函数需转function或用fix doc comment补救。
光标放在函数/类/方法声明行正前方，输入 /** 后直接按 Enter，就能生成带 @param 和 @returns 的标准 JSDoc 框架——这是 WebStorm 原生支持、最稳最快的方式，不需要装插件，也不依赖快捷键记忆。
为什么光标位置决定成败
WebStorm 的 JSDoc 自动生成只在「声明语句正前方」触发，不是任意位置都能用：
- 光标必须紧贴函数名左侧（比如
function foo() {这一行的开头），不能在函数体内、不能在空行、不能在注释后 - 类方法中，
this不会被自动识别为参数，@this得手动加 - 解构参数（如
({ a, b })）或 rest 参数（如...args）常被漏掉，@param行需人工补全类型和说明 - 箭头函数（
const fn = (x) => {}）不被识别为“可注释声明”，得先转成 function 声明再操作，或改用Fix Doc Comment意图操作
用 Fix Doc Comment 补救漏掉的注释
当光标已在函数体内部、或已写了一半注释但格式不对，Ctrl+Shift+A 搜 Fix Doc Comment 是更灵活的选择：
- 它会扫描当前作用域内最近的函数/方法/字段声明，并尝试补齐缺失的
@param、@returns - 对已有注释也能智能合并：比如你写了
/** @param x */，它会保留并补上其他参数，而不是覆盖重来 - 不支持自动推导泛型或复杂联合类型（如
@param {string | number}），这类仍需手写 - 如果函数没返回值，它不会加
@returns；但如果函数体里有return，它可能误判，得检查删掉冗余行
Live Templates 自定义 method* 快捷生成（慎用）
想用 method* + Tab 生成模板？可以，但默认行为容易翻车：
-
$functionName$变量只在函数体内生效，放声明行前是空的——必须进Edit variables把表达式设为methodName() - 模板适用范围要选
Statements或Everywhere in JavaScript，否则新建文件时按method*不触发 - 参数占位行（
@param {type} argName - description）是静态的，没法根据真实参数个数动态生成，多参数时得手动删行 - 别在模板里硬写
@file，JSDoc 规范不认这个 tag；想标归属，用@module或自然语言描述更稳妥
真正容易被忽略的是：JSDoc 注释一旦生成，就参与类型推导和代码补全。如果 @param 类型写错（比如把 {string} 写成 string），后续调用处的类型提示就会失效——这比没写注释还误导人。
