WebStorm 的 Rename（Shift+F6）仅作用于光标所在符号的声明处，且需手动选择“In Project”才跨文件更新；同名变量在不同作用域互不影响；类名重命名不自动同步文件名和 import 路径。
光标没停在声明处，重命名就只是改了个字符串
WebStorm 的 Rename 不是全局文本替换，它只作用于语言级符号定义。如果你把光标放在 console.log(userId) 里按 Shift+F6，它只会改这一处引用——这不是 bug，是设计如此。
真正生效的前提是：光标必须落在变量/函数/类的**声明位置**，比如：
-
const userId = 'abc'中的userId -
function fetchUser()中的fetchUser -
class UserService中的UserService
箭头函数参数、解构赋值变量（如 ({ id }) => {} 中的 id）也支持 Shift+F6，但同样要求光标落在参数名上。
范围选错，“In File” 和 “In Project” 差得远
触发 Shift+F6 后弹出的对话框左下角会显示当前作用域，默认可能是 In File 或 In Selection。这意味着重命名只影响当前文件或选中区域，其他地方完全不动。
要跨文件更新所有引用，必须手动点开下拉菜单，选 In Project。尤其注意以下情况：
- TS 项目中命名导出（
export const apiConfig）改名后，所有import { apiConfig }会自动更新 - 但默认导出（
export default class ApiClient）不参与符号级重命名，需单独处理 - 接口字段重命名不会同步到实现类，这是有意限制，不是遗漏
同名变量在不同作用域，WebStorm 不会“猜意图”
两个文件里都写了 let id = 123，WebStorm 绝不会把它们当同一个符号批量处理——哪怕你心里认定都是“用户 ID”。这是保护机制，防止误改。
如果确认语义一致（比如统一从 userId 改为 userUuid），操作步骤是：
- 逐个文件打开，把光标停在各自
userId的声明处 - 每个都按
Shift+F6，确保范围选In Project - 不要用
Ctrl+Shift+R全局文本替换，除非你已勾选Match case和Words only，否则可能误改userIdToken这类词
重命名类名 ≠ 自动改文件名和 import 路径
这是最容易被忽略的边界：WebStorm 把“重命名符号”和“重命名文件”视为两件事。
只有当你重命名一个**与文件同名的顶层导出**（如 class UserService 在 UserService.ts 中），才会弹出提示：“Rename file to UserService.ts?”。此时点 Yes 才联动改名。
其他情况：
- 类名改了，但文件名没变 →
import { UserService }仍指向原路径，不会自动修正 - 想同步改 import，必须手动重命名文件（右键文件 →
Refactor → Rename）或提前规划好模块结构 - 移动符号（如把函数从 A.ts 提取到 B.ts）要用
F6（Move），不是Shift+F6
