shift+f6（windows/linux）或 ⇧f6（macos）是重命名的正确快捷键，需光标精准落在声明名上且范围设为in project；ctrl+r是纯文本替换，f2仅作用于当前作用域，均无法可靠跨文件重命名。
必须用 Shift+F6（Windows/Linux）或 ⇧F6（macOS），光标精准落在声明名上，且范围选 In Project —— 其他任何方式都可能误改字符串、JSON 键或漏掉 import 引用。
为什么 Ctrl+R 和 F2 不是重命名的正确选择
Ctrl+R 是纯文本替换，不识别作用域：改 userId 时，"user_id"、/user\/\d+/、甚至日志里的 "user ID not found" 都会被波及；F2 默认只作用于当前作用域（比如单个函数内），不会跨文件，也不更新 import 或导出引用。更隐蔽的是：如果光标停在 console.log(user) 的 user 上按 F2，WebStorm 可能只改这一处，根本没追溯到 const user = ... 的源头。
无序列表：
-
Ctrl+R会破坏正则、JSON 键、模板字符串和注释中的字面量 -
F2不分析 AST，无法识别跨文件引用或模块导入关系 - 选中文字后按任意快捷键，WebStorm 自动退化为文本操作，跳过语义分析
Shift+F6 正确触发的三个硬性条件
缺一不可：光标位置、语言识别、项目范围。光标必须落在变量/函数名的完整字符范围内（例如 const userName = 'Alice' 中的 userName 字母上），不能在等号前、空格后，也不能选中整行；状态栏右下角必须显示 JavaScript 或 TypeScript，不是 Plain Text；弹窗左下角必须确认为 In Project，否则默认可能是 In File，导致其他文件里的 import { userName } 完全不动。
无序列表：
- 光标未落在声明名字符范围内 → 重命名菜单灰掉或静默失败
- 文件被识别为
Plain Text→ AST 解析失效，Shift+F6不触发语义重构 - 范围未手动设为
In Project→ 跨文件 import 和 export 不更新，尤其影响 Vue SFC 或 TS 模块
TypeScript 和 Vue 场景下的典型盲区
TypeScript 中重命名 export interface User，不会自动同步 declare module 或 types.d.ts 里的同名声明；Vue SFC 的 <script setup></script> 中重命名 const count = ref(0)，光标若落在 ref 或括号内，会误重构 ref 函数本身，而非 count 变量；defineProps() 中的 msg 是类型参数，Shift+F6 对它无效；defineModel() 的 'value' 是字符串字面量，得靠 Find → Replace in Path 手动处理。
无序列表：
- 接口字段、
declare module、types.d.ts声明需手动同步 -
<script setup></script>中光标必须落在变量名字母上，不能落在函数调用部分 -
defineProps/defineEmits的泛型参数不参与语义重命名 - 动态 key（如
obj[variableName]）、eval、with语句中的变量名 WebStorm 完全不追踪
重命名后仍报错？先检查这三件事
出现 Cannot find name 或组件标签变红，大概率不是重命名失败，而是类型系统或路径映射没跟上。TS 项目里，tsconfig.json 的 paths 别名若未在 Settings > Languages & Frameworks > TypeScript > Compiler 中勾选 Use paths mapping from tsconfig.json，import 路径就不会自动更新；Vue 组件名改了，但 <old-name></old-name> 标签、路由配置里的 component: OldName、app.component('old-name', ...) 都得人工核对；改完立刻重启 TS Server（Ctrl + Shift + P → Restart TypeScript Server）能解决多数缓存延迟问题。
无序列表：
- 检查
tsconfig.json的paths是否被 WebStorm 正确索引 - Vue 组件名变更后，所有 JSX 标签、路由配置、全局注册字符串必须手动更新
- TS 报错延迟常见，重启 TS Server 比反复 Invalidate Caches 更快见效
