应使用Shift+F6快捷键进行语义级重命名：光标精确定位声明名→按Shift+F6→输入新名→确认范围为In Project→回车执行，确保仅更新有效引用，跳过字符串、注释及无关同名标识符。
如果您在 WebStorm 中需要安全、精准地修改变量、函数或类的名称，但发现直接文本替换导致字符串、注释或 JSON 键名被误改，则说明未使用语义级重构机制。以下是正确触发 Rename 重构并实现一键修改的操作路径：
一、使用 Shift+F6 快捷键执行全范围重命名
Shift+F6 是 WebStorm 中最稳定、最推荐的重命名快捷键，它会自动识别光标下符号的语言级定义，并根据作用域智能确定更新范围，避免误改非引用位置。
1、将光标**精确停放在变量/函数/类的声明名称上**（例如 const userName = 'Alice' 中的 userName 全部字符范围内，不能落在等号或空格上）。
2、按下 Shift+F6（Windows/Linux）或 ⇧F6（macOS），弹出重命名对话框。
3、在输入框中键入新名称，如 customerName。
4、确认左下角显示的范围为 In Project；若显示 In File 或 In Selection，需点击下拉箭头手动选择“Search in Project”。
5、按 Enter 确认，WebStorm 将解析 AST，仅更新该符号所有有效引用处，跳过字符串、注释及不同作用域的同名标识符。
二、通过右键菜单调用 Refactor → Rename
当快捷键记忆不牢或需临时确认操作意图时，右键菜单提供可视化入口，其底层行为与 Shift+F6 完全一致，同样依赖光标位置和语言上下文识别。
1、用鼠标**单击选中要重命名的变量/函数/类名的完整字符**（确保状态栏右下角语言标识为 JavaScript 或 TypeScript，而非 Plain Text）。
2、右键单击该名称，在上下文菜单中选择 Refactor → Rename。
3、在弹出的对话框中输入新名称，注意检查下方预览窗口是否列出全部待更新引用位置。
4、取消勾选 Search in comments and strings（除非明确需要修改日志文本中的相似词）。
5、点击 Refactor 按钮完成批量同步修改。
三、使用 F2 进行轻量级局部重命名
F2 适用于快速修改当前作用域内已明确声明的局部变量或函数参数，不默认跨文件传播，适合调试阶段临时调整，响应更快但作用域受限。
1、将光标置于函数内部声明的 let item 或 const index 等局部标识符上。
2、按下 F2，此时仅高亮当前作用域内对该变量的所有读写引用。
3、输入新名后回车，WebStorm 仅更新该函数体或块级作用域内的全部引用，不触及其他文件或顶层声明。
4、若该变量为 export 声明，F2 不会弹出跨文件提示；此时应改用 Shift+F6 并确保范围设为 In Project。
四、针对 TypeScript 接口与类属性的重命名强化操作
TypeScript 类型系统增强了重构准确性，但需确保项目配置支持完整符号追踪，否则接口字段或类属性重命名可能遗漏实现类中的对应字段。
1、打开项目根目录下的 tsconfig.json，确认包含以下配置项：
2、在 "compilerOptions" 中启用 "allowSyntheticDefaultImports": true 和 "esModuleInterop": true。
3、在 WebStorm 设置中进入 Languages & Frameworks > TypeScript > Compiler，勾选 Use paths mapping from tsconfig.json。
4、对 interface User { name: string } 中的 name 字段重命名时，务必把光标停在 interface 声明体内的字段名上，再按 Shift+F6。
5、若重命名后实现类中同名属性未同步，检查该类是否通过 import type 引入接口，此时需手动更新实现类字段——WebStorm 不自动重构类型导入中的字段引用。
