WebStorm代码补全与重构依赖三要素：右下角状态栏须显示JS/TS/Svelte（非Plain Text）、tsconfig.json路径映射需启用、Svelte等框架插件须手动安装；光标不可选中文本，否则Shift+F6退化为文本替换。
WebStorm 的代码补全和重构不是“开了就灵”，它高度依赖项目配置、光标位置和语言识别状态。没配对 tsconfig.json 或没启用 Svelte 插件，className 就不会自动转成 class；光标选中了文字再按 Shift+F6，重命名就退化成全文本替换。
补全不出现？先看这三件事
补全弹窗不弹、建议不准、JSX 里 className 不提示修正，往往不是功能坏了，而是基础链路断了：
- 右下角状态栏必须显示
JavaScript、TypeScript或Svelte—— 如果是Plain Text，补全直接失效 - TS 项目要确认
Settings > Languages & Frameworks > TypeScript > Compiler中勾选了Use paths mapping from tsconfig.json，否则别名路径（如@/components）无法解析，补全找不到模块 - Svelte 项目必须手动安装并启用
Svelte插件（Settings > Plugins > Marketplace），否则$:声明、bind:指令等语法不被识别，补全和重构全挂
Shift+F6 重命名只改局部？检查光标和作用域
重命名漏改、跨文件不动、参数名改了但调用处没变，基本都出在语义分析没跑起来：
- 光标必须停在变量/函数名的任意一个字符上，**不能选中任何文字**——选中了就触发文本查找替换，不是 AST 重构
- 在类方法内重命名
this.name，默认只改当前类；想同步更新子类实现，得在重命名弹窗里点齿轮图标，勾选All places - 对
var声明或未声明直接赋值（userName = 'jack'）的变量，WebStorm 常报Cannot refactor，因为无法静态推断作用域 - 字符串里写
"user" + "Name"不会被识别为userName引用，即使勾了Search in comments and strings，也只会字面替换，不保证逻辑安全
Ctrl+Alt+M 提取方法失败？看代码块是否“自洽”
报错 Cannot extract fragment 不代表代码有语法错误，而是 WebStorm 拒绝切片不完整的逻辑单元：
- 必须选中完整语句块：比如
if (x) { console.log(x); }可以提，但只选console.log(x);就失败 - 不能跨 JS/JSX 边界：选中
return <div>{user.name}</div>;会失败，因为含return且混用 JSX 表达式 - 模板字符串内部不能触发：在
`Hello ${name}`里只选中${name}，WebStorm 不识别为可提取表达式 - 提取后参数顺序按“首次读取”排列，不是声明顺序——想控制入参顺序，得先调整原代码里变量的使用次序
重构后 import 没更新？路径映射没生效
移动文件、重命名组件后，其他文件里的 import 还指着旧路径，大概率是 WebStorm 没读到你的路径配置：
- 确认
tsconfig.json在项目根目录，且含有效compilerOptions.baseUrl和paths - 进
Settings > Languages & Frameworks > TypeScript > Compiler，确保勾选Use paths mapping from tsconfig.json - 检查
File > Project Structure > Modules，目标源码目录是否标记为Sources（蓝色图标），否则 WebStorm 当它不存在 - 修改完配置后，执行
Ctrl + Shift + P → Restart TypeScript Server，否则缓存路径不会刷新
最常被忽略的是：重构操作本身不校验运行时行为。比如 Change Signature 给函数加必填参数，WebStorm 会自动补 undefined 或空字符串，但业务逻辑是否允许这个默认值，得你亲自看。
