重命名未同步的根本原因是光标未置于声明处或未触发完整重构；webstorm的rename仅作用于语言级定义，需在声明位置用shift+f6并确认范围为“in project”，跨作用域同名变量需分别操作，接口重命名不自动更新实现类字段。
重命名变量时，为什么改了名字但其他地方没同步？
根本原因不是操作失败，而是光标没停在“声明处”或没触发完整重构。WebStorm 的 Rename 重构只作用于符号的**语言级定义**（比如 const foo = 1 中的 foo），而不是任意字符串。如果你把光标放在 console.log(foo) 里按 Shift+F6，它可能只重命名这个引用，而非整个变量——这是最常被误踩的坑。
- 务必把光标放在变量/函数/类的 声明位置（如
function calculateTotal()的calculateTotal上，或class ApiClient的ApiClient上） - 别用
Ctrl+R（那是“替换文本”，非重构），要用Shift+F6或右键 →Refactor → Rename - 检查对话框左下角是否显示 “In Project” 范围；如果显示 “In File” 或 “In Selection”，说明范围受限，需手动点开下拉选全项目
批量重命名多个同名变量，但它们其实是不同作用域的，怎么办？
WebStorm 默认不会跨作用域合并重命名——这是保护机制，不是 bug。比如两个文件里都有 let id，但一个是用户 ID，一个是订单 ID，它不会强行一起改，否则就乱了。
- 若你确认是同一语义（比如统一把
userId改成userUuid），确保每个userId都是在其各自声明处触发Shift+F6，WebStorm 会分别处理各自作用域内的所有引用 - 如果想一次性覆盖多个文件里的同名局部变量（不推荐），只能用
Ctrl+Shift+R（全局文本替换），但必须勾选Match case和Words only，否则会误改userIdToken这类词 - 注意：箭头函数参数、解构赋值中的变量名也支持
Shift+F6，但需光标落在参数名上（如(<code>item) => {...} 中的item）
重命名后 import 路径没更新，文件名也没变，正常吗？
正常。WebStorm 把“重命名符号”和“重命名文件”视为两个独立操作。只有当你重命名一个 **与文件同名的顶层类/函数/常量**（如 class UserService 在 UserService.ts 中），它才会弹出提示：“Rename file to UserService.ts?”——这时才联动。
- 如果类名改了但文件没动，import 语句里的路径仍指向原文件名，不会自动修正
- 想同步改文件名：先用
Shift+F6重命名类，看到提示后点 “Yes”；或者右键文件 →Refactor → Rename单独操作 - TS 项目中，如果改了导出名（如
export const apiConfig→export const clientConfig），所有import { apiConfig }处都会自动更新——前提是导出是命名导出，不是export default
为什么 TypeScript 接口重命名后，实现类里报错说“缺少属性”？
因为 WebStorm 重命名接口时，默认只改接口定义和 implements 语句，但不会自动更新类里缺失的字段声明——它认为这是你需要手动补全的逻辑契约，不是纯符号替换。
- 例如把
interface User改成UserDto，类class UserImpl implements User会变成implements UserDto，但类体内name: string等字段不会自动生成或重命名 - 此时错误是故意的：提醒你检查实现是否还满足新接口要求
- 若接口字段名也变了（如
userName→fullName），得单独对字段用Shift+F6，且必须在接口定义里操作，不能在实现类里点
Preview 按钮），比盲目执行安全十倍。
