webstorm不生成最终代码，仅提供触发入口和上下文感知；真正执行的是jsdoc等外部命令行工具，需正确配置external tools并确保jsdoc已全局安装且路径可达。
WebStorm 本身不生成最终代码，它只提供触发入口和上下文感知；真正生成代码的是外部命令行工具（如 jsdoc、node、tsc）或系统级程序。光靠点菜单或快捷键不出结果，是因为没配好外部工具链。
怎么让 WebStorm 调用 jsdoc 生成 HTML 文档
WebStorm 不生成 index.html，它只帮你写好 @param 这类注释。生成网页必须走命令行：jsdoc 工具才是执行者。
- 先确认已全局安装：
npm install -g jsdoc；若用 nvm 或 pnpm，确保当前 shell 能调到jsdoc命令 - 在 WebStorm 中配置 External Tools：Settings → Tools → External Tools → + → 填入：
Name:jsdoc
Program:jsdoc
Arguments:-d ./docs $FilePath$（$FilePath$是 WebStorm 变量，代表当前文件路径）
Working directory:$ProjectFileDir$ - 配置完后，右键任意 JS/TS 文件 → External Tools →
jsdoc，就会在项目下生成./docs目录 - 常见失败点：
jsdoc找不到函数声明——说明你写的 JSDoc 没紧贴function行开头；或者用了解构参数但没手动补@param {Object}类型描述
Alt+Insert 生成 getter/setter 为什么没反应
这不是插件没开，而是光标不在有效作用域内。WebStorm 的 Alt+Insert（macOS 是 ⌘N）完全依赖上下文解析，不是全局快捷键。
- 光标必须落在类体内部，且不能在方法体内、字符串中、注释里或空行上；最稳妥的位置是字段声明行（如
name: string;这一行） - 字段必须有明确类型或初始值，例如
age = 0或status: 'idle' | 'loading'；只写name;（无类型、无默认值）会被忽略 - 如果字段是
private readonly name: string，生成的setName()会报错——WebStorm 不自动跳过只读字段，你得手动取消勾选 setter - TypeScript 中联合类型字段（如
status: 'idle' | 'loading' | 'error'）生成的 setter 不带运行时校验，得自己加if (!['idle','loading','error'].includes(value)) throw new Error(...)
Live Templates 自定义代码片段不展开
缩写输对了但按 Tab 没反应？大概率是模板没绑定语言作用域，或被内置模板占了坑。
- 进 Settings → Editor → Live Templates → 找到你的模板 → 点
Define→ 必须勾选对应语言，比如 React Hook 模板要同时勾JavaScript和React JSX，只勾一个不行 - 缩写区分大小写：
ue和UE是两个模板；log是内置的，你再建个log就不会生效 - 输入缩写后弹出灰色补全提示（比如显示 “log: console.log()”），说明当前上下文不匹配——可能你在字符串里打
clg，或在 CSS 文件里打flex - 务必勾选
Reformat according to style，否则生成的代码缩进错乱，尤其嵌套结构里会一眼看出
所有外部工具调用都卡在「路径没认对」或「上下文没识别到」这两个点上。WebStorm 不猜你要干什么，它只响应它看得到的语法结构和文件状态。写完代码别急着点，先看右下角语言标识是不是你想要的（比如 TypeScript 而不是 Plain Text），再检查光标有没有贴着声明行最左边——这是绝大多数问题的起点。
