Shift+F6是WebStorm唯一安全重命名方式，因它基于AST语义分析，精准识别声明与引用；F2仅限当前作用域，Ctrl+R为纯文本替换，均无法跨文件或区分字符串/注释中的同名内容。
Shift+F6 是 WebStorm 中唯一推荐用于安全重命名的快捷键，它触发语义级重构，而非文本替换。F2 或误选中后按 Rename 会绕过 AST 分析，导致漏改或误改。
为什么 Shift+F6 才算真正安全
WebStorm 的 Rename 重构依赖 AST（抽象语法树）识别符号定义与引用关系，Shift+F6 是唯一默认绑定该语义行为的快捷键。它能区分：
-
const userName = 'Alice'中的userName（变量声明）和字符串'user name not found'（字面量） - 同名但不同作用域的
id：函数参数、对象属性、全局变量 - TS 中类型别名与值名冲突时，只改值引用，不碰
type声明
而 F2 默认只作用于当前作用域（如单个函数体内），Ctrl+R（Replace in Path）则是纯文本暴力替换——这两者都不具备跨文件、跨作用域的引用追踪能力。
光标位置决定重构是否生效
重构失败最常见的原因是光标没落在“语言级标识符”上。不是“看起来像变量名”，而是 WebStorm 能从中解析出 AST 节点的位置：
- ✅ 正确：光标停在
function fetchData()的fetchData字母范围内（不含括号、空格） - ❌ 错误：光标停在
fetchData前后空白处、等号右侧、字符串内部、注释行中 - ⚠️ 风险：文件右下角状态栏显示
Plain Text而非JavaScript或TypeScript—— 此时Shift+F6会静默退化为文本替换
若右键菜单中 Refactor → Rename 灰掉，基本可判定光标未命中有效符号或文件类型识别失败。
Search in comments and strings 为什么不能默认勾选
这个选项本质是关闭语义隔离，把 Rename 变成带范围限制的文本替换。实际项目中极易引发问题：
- 改
userId时勾选它，会连"user ID not found"、// userId cache timeout一起改 - JSON 键名如
{"userId": 123}被当成字符串处理，改完变成{"customerId": 123}—— 但后端接口未必接受 - 日志模板中的占位符如
`User ${userId} logged in`会被误改，破坏插值逻辑
除非你明确知道所有匹配项都应同步变更（例如统一修改路径常量字符串），否则保持默认不勾选才是安全底线。
TS 项目里重命名漏改的隐藏原因
TypeScript 环境下 Rename 失效往往不是操作问题，而是类型系统干扰了符号解析：
-
export default class User重命名为Customer后，其他文件里import User from './user'没更新？检查tsconfig.json是否启用了"allowSyntheticDefaultImports": true - 使用
declare module扩展第三方库类型时，若重命名涉及该模块内导出，需重启 TypeScript Server（Ctrl+Shift+P→ “Restart TS Server”） - 动态 key 访问如
obj[variableName]永远不会被Shift+F6追踪——这是设计使然，不是 bug
重构不是万能的，尤其当代码存在 eval、with、Proxy 或运行时拼接属性名时，Shift+F6 的安全边界就止步于此。这时候得靠人工核对 + 单元测试兜底。
