webstorm重命名变量需光标置于声明标识符上且文件类型正确，shift+f6默认仅限当前文件，跨文件需手动选in project；动态引用、模板字符串、jsx属性等无法被语义识别，须人工核验。
重命名变量没同步，不是功能失效，而是你没触发语义级重构——WebStorm 默认只改当前作用域内被 AST 识别到的引用，不是全局文本替换。
为什么 Shift+F6 没反应或只改了局部
最常见原因是光标没落在语言级定义位置。WebStorm 的 Rename 依赖符号解析，它不认“看起来像变量”的字符串，只认声明点或明确导出的标识符。
- 光标必须停在
const user = {}中的user上（不能在等号后、空格里，也不能选中整个const user） - 文件右下角状态栏显示为
Plain Text而非TypeScript或JavaScript时，重构菜单会灰掉 -
eval()、new Function()、模板字符串动态拼接的变量（如obj[`${key}Id`]）无法被静态分析，Rename必然跳过 - Vue SFC 的
<script setup></script>中，要重命名const count = ref(0)，光标得落在count上，而不是ref或括号内
怎么确保改到所有引用处
关键看弹窗左下角的范围提示。默认行为是“当前文件”，不是“整个项目”——这是多数人漏掉的一步。
- 按
Shift+F6后，对话框左下角若显示In File，点击下拉箭头，手动选In Project - 如果是
export的变量/函数/类，WebStorm 通常会自动弹出“是否更新所有 import 处”的勾选项；但若没弹，说明它没识别出跨文件导出关系，检查tsconfig.json的compilerOptions.paths是否配置了别名映射 - TS 项目中重命名接口字段后，实现类里的属性不会自动补全，因为 IDE 不认为那是“引用”，而是契约约束，需手动添加
重命名后 import 路径或文件名没变，正常吗
完全正常。WebStorm 把“重命名符号”和“重命名文件”视为两个独立操作。
- 只有当你重命名一个与文件同名的顶层导出（如把
class UserService改成UserClient），它才会弹提示：“Rename file to UserClient.ts?” - 如果拒绝该提示，
import { UserService } from './UserService'里的路径不会变，也不会报错——因为模块路径和符号名无关 - 想同步改文件名：先用
Shift+F6重命名类，看到提示后点Yes；或右键文件 →Refactor → Rename单独操作
哪些地方必须人工核验
即使弹窗显示“23 处已更新”，这数字也不代表安全。尤其当项目用了 Babel 插件、自定义 ESLint 规则、运行时依赖反射（比如装饰器元数据），或存在未被 tsconfig.json.include 覆盖的类型声明文件，重构就可能漏掉关键位置。
- 所有
declare module声明中的旧名（如declare module 'xxx' { export const oldName: ... }） - JSON Schema 文件、mock 数据、测试用例里的字符串字面量（
Rename默认不碰这些，除非你手勾了Search in comments and strings） - JSX 属性名（如
className）、React.memo 包裹名、自定义 Hook 内部调用点——这些属于弱关联，不在语义分析范围内
