shift+f6无法重命名模板字符串中的变量名，因其仅识别声明处的标识符；extract method需选中完整声明语句；勾选search in comments and strings会误改插值内容；动态路径中的变量无法被索引。
Shift+F6重命名模板字符串里的变量名会失败
WebStorm 的 Rename（Shift+F6）对模板字符串内部的变量引用是“只读识别”，不支持直接重命名。比如你写 `${user.name}`，光标停在 name 上按 Shift+F6，它不会触发重构——因为 name 在这里不是独立声明的标识符，而是属性访问表达式的一部分。
常见错误现象：右下角状态栏显示 JavaScript，但弹窗空白或提示 “No refactorings available”；或者误以为选中整个 ${user.name} 就能改，结果只是文本替换。
- 真正可被语义重命名的，只有声明处的变量名（如
const userName = ...）和函数参数名 -
user.name中的name属于属性访问，WebStorm 不将其视为可重构符号；要改它，得先改user对象的类型定义或接口字段（如 TypeScript 中的interface User { name: string }） - 如果项目用了
jsconfig.json或tsconfig.json但没配compilerOptions.paths，类型推导断裂，连user本身都可能无法被正确追踪
把 + 拼接转成模板字符串时 Extract Method 容易报错
想把 let msg = "Hello " + firstName + " " + lastName; 提取为函数并改用模板字符串？别直接选中拼接行按 Ctrl+Alt+M。WebStorm 会拒绝，因为加号拼接属于表达式，而 Extract Method 默认只接受完整语句块（statement），不是纯表达式（expression）。
实际能成功提取的最小单位是带 const 声明的整行，比如：const msg = "Hello " + firstName + " " + lastName;
- 必须选中整条声明语句（从
const到分号），不能只选等号右边 - 提取后生成的函数默认返回值是
msg，但如果你后续想改成`Hello ${firstName} ${lastName}`，得手动编辑函数体——WebStorm 不会自动转换拼接逻辑 - 若原代码在 React 组件里且依赖闭包变量（如
firstName来自 props），提取后这些变量会作为参数传入，但参数顺序按“首次读取位置”排，不是声明顺序；想调序，得立刻用Change Signature（Ctrl+Shift+P）拖拽
Search in comments and strings 勾选后模板字符串反而更危险
有人为了“确保改全”，在 Rename 弹窗里勾选 Search in comments and strings，结果把模板字符串里的占位符也替换了。例如重命名 userName，却把 `Welcome, ${userName}!` 改成 `Welcome, ${newName}!` ——看起来对，但其实破坏了语义：WebStorm 并不理解 ${...} 是插值语法，它只是粗暴匹配字符串字面量中的文本。
更糟的是，它还会误改注释里的示例、日志模板、甚至正则表达式字面量中的类似结构。
- 模板字符串本身是字符串字面量的一种，一旦勾选该选项，所有
${xxx}都会被当作普通文本处理 - 真正安全的做法是：先用
Shift+F6重命名声明和引用，再单独用Ctrl+Shift+F搜索\$\{userName\}（开启 Regex）做精准替换 - 搜索时务必限定文件掩码（如
*.ts），避开 JSON、HTML 和配置文件，防止误伤
Webpack/Vite 别名路径里的模板字符串无法被索引
当模板字符串用于动态导入或路径拼接，比如 import(`../components/${name}/index.ts`) 或 require(`@/utils/${type}.js`)，WebStorm 根本看不到这些路径中的 name 或 type 变量——它们是运行时求值的，不属于静态分析范围。
这意味着：即使你用 Shift+F6 把 name 重命名为 componentName，上面那行 import() 里的 ${name} 不会变，也不会报错，直到运行时报 Module not found。
- 这类动态路径不在 WebStorm 的语义索引范围内，无论
jsconfig.json是否配了paths都无效 - 解决办法只有两个：一是避免在 import() 中用变量拼路径（改用静态 import + 条件分支）；二是重命名后手动 grep 全局搜索
\$\{name\}，逐个确认 - 如果项目用了 Vite 的
@/别名，记得在Settings > Languages & Frameworks > JavaScript > Webpack里填好配置路径，否则连静态import "@/utils/foo"都可能索引失败，更别说动态的了
${} 里的变量何时生效、在哪求值——这点在重构时最容易被忽略。
