F2最安全是因为它基于语言服务器（LSP）进行语义级重命名，仅修改真实引用位置，自动排除字符串、注释、不同作用域同名标识符等；而Ctrl+H和Ctrl+D是纯文本替换，无语义识别，易误改。
F2 是最安全的键，但必须满足语言服务正常工作的前提；按了没反应或改错地方，基本不是快捷键问题，而是语义分析链路断了。
为什么 F2 比 Ctrl+H 或 Ctrl+D 更安全
F2 触发的是 editor.action.rename 命令，背后是语言服务器（LSP）做的符号解析：它只改当前变量/函数真正被引用的位置，自动跳过字符串、注释、正则字面量、模板插值、不同作用域的同名标识符。比如你重命名 userId，"user_id" 和 const userId = 123（在另一个函数里）都不会动。
而 Ctrl+H 是纯文本搜索替换，Ctrl+D 是逐个选中相同字符串——两者都不区分语义，一不小心就把 user_id 改成 user_newId，或者把日志里的 userId not found 也一起替了。
实操建议：
- 光标必须落在变量名**内部任意位置**（不能在空格或点号上），否则 LSP 无法定位符号
- 重命名过程中所有将被修改的位置会用灰色背景高亮，这是唯一能快速确认范围是否合理的窗口
- 改完立刻看底部状态栏提示的 “Changed X references in Y files”——若为 0，说明 LSP 根本没识别到引用，别信它改成功了
F2 不生效的三个硬性检查点
VSCode 不报错、不弹窗、只是灰掉或按了没反应，大概率卡在这三处：
- 右下角语言模式显示的是
Plain Text而不是TypeScript/JavaScript/Python等——点击可手动切换 - 项目根目录缺失
tsconfig.json（TS）或jsconfig.json（JS），哪怕内容只有{"compilerOptions": {}}也得有 - 目标变量没被正确导出或导入：
function foo() {}不加export，跨文件调用处就不会被 LSP 索引到
特别注意：Vue 的 <script setup> 默认不和 <template> 联动重命名，需在 settings.json 加 "javascript.preferences.renameShorthandProperties": true（仅对 JS/TS 有效，不影响模板）。
跨文件重命名失败时，别硬等，先验证定义链路
跨文件改一个 fetchUser 函数名却只改了当前文件？不是功能坏了，是 LSP 没法从调用处顺藤摸到定义。
实操建议：
- 先把光标停在调用处（比如
fetchUser()），按F12（Go to Definition）——跳转失败，F2 必定失败 - 检查导入路径是否可解析：
import { fetchUser } from '@/api'中的@/api是否真导出了fetchUser？路径别名配置（jsconfig.json的compilerOptions.paths）有没有生效？ - 打开命令面板
Ctrl+Shift+P，输入Developer: Toggle Developer Tools，看 Console 里有没有Failed to resolve definition类报错
动态引用永远逃逸于 F2：比如 obj[methodName]、eval(methodName + '()')、setTimeout(methodName, 100) ——这些地方必须人工核对，F2 压根不会碰。
当 F2 真的不可用，该怎么换策略
不是所有场景都适合 F2。比如你要批量改掉所有 tempData → rawData，且确认全文没有误匹配风险（比如没出现在字符串或注释里），那就该换更直接的方式。
实操建议：
- 想全文件替换同名变量（非语义）：先双击选中一个
tempData，再按Ctrl+Shift+L全选所有匹配项，然后输入新名——比Ctrl+D更快、更稳 - 需要带上下文过滤（如只改
const tempData =开头的）：开Ctrl+H，勾选Match Case和Whole Word，必要时启用正则，写const\s+tempData\s+= - 批量改一堆文件名？别用插件。用终端：
rename 's/tempData/rawData/g' *.js（Linux/macOS）或PowerShell -Command "Get-ChildItem *.js | Rename-Item -NewName {$_.Name -replace 'tempData','rawData'}"（Windows）
真正容易被忽略的点是：F2 的“安全”只在语言服务能看清代码结构时才成立。一旦遇到 any 类型、未声明的全局变量、动态 key、IIFE 包裹的函数，它就退化成普通文本替换——而你根本不会收到任何警告。
