shift+f6是语义级重命名，仅更新ast可识别的引用；ctrl+shift+r是纯文本替换，会误改注释、字符串、正则等非变量位置，无法保证类型安全与作用域正确性。
直接用 Shift+F6 重命名变量，WebStorm 会自动识别作用域、更新 import/export、处理 JSX 和模板字符串里的引用——前提是别把它当普通文本替换用。
为什么不能用 Ctrl+Shift+R 替换变量名
全局文本替换（Ctrl+Shift+R）不区分语法角色：它会把 user.id、"user.id"、// user.id is deprecated、甚至正则字面量 /user\.id/g 全部干掉。变量重命名不是字符串替换，而是 AST 层面的语义操作。
- 改
const name = "Alice"中的name，Ctrl+Shift+R可能误改username或rename - JSX 里
<user name="{name}"></user>中的name不会被文本替换识别为变量引用 - 类型声明如
interface User { name: string }里的name完全不会被命中 - TS 中
function getName(): string的参数名name也不会被Ctrl+Shift+R关联到函数体内的使用
Shift+F6 重命名的正确触发方式
光标必须落在变量名**内部任意位置**（比如 userName 的 u、s 或 r 上），不能停在前后空白处或等号/括号上；否则弹不出重命名菜单。
- 对导出的变量（
export const apiHost = "..."），Shift+F6会同步更新所有import { apiHost }和重命名后的导入名 - 若变量在解构中（
const { id, title } = post），单独选中id按Shift+F6，只改这一处解构名，不影响其他地方的id - 想跨文件改同名但不同作用域的变量？不行——
Shift+F6默认只改当前符号的所有引用，不同声明就是不同符号 - 需要连注释和字符串一起改？勾选对话框里的
Search in comments and strings，但要小心误伤（比如改data时命中"data.json"）
容易被忽略的边界情况
重命名后编译或运行时报错，大概率是这几处没被覆盖：
-
JSDoc注释里的@param {string} userName—— 默认不参与重命名，需手动勾选Search in comments and strings - Vue SFC 的
<template></template>区域绑定（{{ userName }}）—— WebStorm 2023.2+ 支持，但需确保 Vue 插件启用且文件类型识别正确（.vue后缀已绑定到 Vue 类型） - TypeScript 接口/类型别名中的字段名（
type User = { userName: string }）—— 属于类型定义，Shift+F6不动它；得用Refactor → Rename单独选中字段再操作 - Webpack/Astro/Vite 配置里的字符串路径（
resolve.alias: { "@utils": "./src/utils" }）—— 这些纯字符串，只能靠Ctrl+Shift+R，但务必先预览、关Words only、开Match case
真正麻烦的不是找不到怎么改，而是改完发现 userName 在类型定义、JSDoc、HTML 属性值或配置文件里还留着旧名字——这些地方不在 AST 范围内，得靠人眼+针对性搜索补漏。
