shift + f6 安全重命名因基于 ast 仅改语义标识符，跳过字符串/注释；误改常因 node_modules 未参与、动态访问失效或类型字段未确认，需勾选 update references 并 preview。
重命名变量时，别用“替换全部”——它会误改字符串和注释，正确做法是用 Shift + F6 触发语义化重命名。
为什么 Shift + F6 比 Ctrl+R 更安全
WebStorm 的 Shift + F6 不是文本替换，而是基于 AST 的符号重命名：它只改当前作用域内真正被声明、引用的变量标识符，自动跳过字符串字面量、正则、注释、JSON 键名等非代码逻辑部分。
- 比如你重命名
userName，"userName"或// userName is required不会被动 - 如果变量在多个文件中被 import/export 使用，
Shift + F6默认勾选「Search in comments and strings」为关闭状态，可手动开启（但通常不该开） - 对 TypeScript 接口字段、React 组件 props、解构赋值等上下文敏感，能区分
const { name } = user和user.name是否属于同一语义引用
重命名后没生效？检查这三处
常见“改了但没改”的原因不是快捷键失灵，而是 WebStorm 没识别出引用关系：
-
node_modules中的依赖默认不参与重命名 —— 如果你在重命名一个从第三方包导出的变量（如import { debounce } from 'lodash'），Shift + F6会提示「Symbol is not editable」 - 变量被动态访问时失效：比如
obj[variableName]或eval(`${varName} = 1`)，这类无法静态分析的引用不会被纳入重命名范围 - TypeScript 类型别名或接口字段重命名需额外确认：光标放在
type User = { name: string }的name上按Shift + F6，WebStorm 会问你是否要同时改所有同名字段 —— 这里容易误点「No」
跨文件重命名失败的典型场景
当变量在另一个模块中通过 default export 或命名 export 被引用，而你没打开「Update references in other files」选项（默认开启），就可能漏改：
- 确保弹出的重命名窗口左下角勾选了
Search in comments and strings（通常不勾）、Update references in other files（必须勾）、Preview changes（建议勾，可提前看影响范围） - 如果项目用了
export * from './xxx'，WebStorm 可能无法追踪到间接引用 —— 此时需先手动展开 re-export 链，或改用显式 export - Vue 单文件组件中
defineProps()里的userName属于类型参数，Shift + F6默认不处理；需把光标放在props.userName的运行时使用处再触发
真正卡住人的从来不是快捷键记不住，而是重命名后发现某个地方还留着旧名字——那大概率是动态访问、未导出绑定、或是类型定义和运行时引用没对齐。多点一次 Preview，比跑两遍 E2E 测试省时间。
