F2重命名才是安全批量改变量名的方式，因它基于语言服务器语义识别，而Ctrl+Shift+H纯文本替换易误伤字符串、注释及同名标识符。
F2 重命名才是正经批量改变量名的方式，Ctrl+H 或 Ctrl+Shift+H 做纯文本替换风险极高，容易误伤字符串、注释、其他同名标识符。
为什么不能直接用 Ctrl+Shift+H 替换变量名
全局搜索替换（Ctrl+Shift+H）本质是字符串匹配，它不理解代码结构：
- 会把
"user_id"里的user也替换成userId，破坏 JSON 字符串或 API 路径 - 会修改注释里的
// user is deprecated，导致文档错误 - 无法区分局部变量
const user = ...和全局常量USER_ROLE，大小写或前缀不同也照换 - 若项目没配
jsconfig.json或语言服务未就绪，F2失效时，强行用正则（如\buser\b）仍可能漏掉 JSX 属性、模板字符串中的引用
F2 重命名真正生效的三个前提
F2 不是快捷键魔法，它依赖语言服务器识别符号语义。以下任一缺失都会退化为“当前文件内文本替换”：
- 右下角状态栏必须显示
JavaScript、TypeScript等有效语言模式，而非Plain Text或Auto-detect - 项目根目录需存在
jsconfig.json（JS）或tsconfig.json（TS），且至少含"include": ["**/*"]和"exclude": ["node_modules"] - 光标必须落在变量声明处（如
const userName = ...的userName上），不能停在等号后、引号内、点号后或注释中
验证是否真跨文件：按住 Ctrl（Windows/Linux）或 Cmd（macOS）并鼠标点击该变量——能跳转到所有引用位置，才算准备就绪。
当 F2 确实失效时，正则替换的底线操作
仅在确认语言服务不可用、且变量命名有强规律（如全部带固定前缀/后缀）时，才考虑 Ctrl+Shift+H + 正则。必须同时满足：
- 启用
.*按钮（右下角出现Regex标签），否则\b、$全部失效 - 搜索用
\boldVarName\b（\b是单词边界，防子串匹配），不用oldVarName - 替换用
newVarName，不要加$1等捕获组——这里不需要提取内容，只需精确替换 - 在
files to include中填**/*.js、**/*.ts等明确后缀，避免扫进.md或.json
例如：想把所有 apiUrl 改成 baseUrl，搜索填 \bapiUrl\b，替换填 baseUrl，并提前 git checkout -b rename-apiurl 备份。
最易被忽略的细节：多光标选中 vs 语义重命名
Ctrl+D 和 Ctrl+Shift+L 是单文件内操作，和“全局”无关：Ctrl+D 是顺序选中下一个完全匹配项，Ctrl+Shift+L 是全选当前文件所有匹配项。它们都不跨文件，也不做作用域判断。真正需要改多个文件里的同名变量时，别贪快跳过 F2 的配置验证——花两分钟补好 jsconfig.json 并重启 TS Server，比手动核对 20 个文件的替换结果省心十倍。
