F2是唯一可靠的一键重命名入口，但失效主因是语言服务未就绪：状态栏语言模式错误、光标未落在完整标识符上、缺失tsconfig.json/jsconfig.json/pyproject.toml、未安装Pylance等扩展，或Ctrl+Click无法跳转定义。
F2 是唯一可靠的一键重命名入口，但按了没反应，基本不是快捷键问题，而是语言服务没接管该符号。
为什么 F2 按下后没反应或只改当前行
VSCode 的 F2 不是文本替换，它依赖语言服务器（LSP）做语义分析。常见失效原因包括：
- 右下角状态栏显示的是
Plain Text或错误语言模式（比如本该是TypeScript却显示JavaScript） - 光标没落在完整标识符上：停在
userName末尾空格、引号内、括号里，或只选中部分字符（如只选中name而非整个userName） - 项目根目录缺少必要配置文件：
tsconfig.json（TS/JS）、pyproject.toml（Python）、jsconfig.json（JS） - Python 项目没装
Pylance（旧版Python扩展不支持跨文件重命名） -
Ctrl+Click无法跳转到定义——这是 F2 可用的前置验证条件
如何确认语言服务已就绪
别猜，直接验证：
- 按
Ctrl+Click（macOS 为Cmd+Click）点击目标符号，能跳转到定义才说明 LSP 已索引成功 - 打开命令面板（
Ctrl+Shift+P），输入Developer: Toggle Developer Tools，切换到 Console 标签页，看是否有tsserver或pyright启动失败日志 - TypeScript 项目检查
tsconfig.json是否含"strict": true；Python 项目确认pyproject.toml中有[tool.pyright]配置段 - 重启 VSCode 或手动重启语言服务器：
Ctrl+Shift+P→ 输入TypeScript: Restart TS server（或对应语言的重启命令）
哪些地方 F2 绝对不会改，必须人工查
语言服务器只处理静态可推导的引用，以下情况它完全无视，也不会警告：
-
obj["user" + "Name"]—— 字符串拼接，键名运行时才确定 -
const key = "userName"; obj[key]—— 属性名来自变量 -
const x: any = {}; x.userName—— TypeScript 中any类型绕过类型检查 -
<UserCard userName="x" />—— JSX 属性若未在组件类型中声明userNameprop，就不算符号引用 - 日志字符串里的硬编码：
console.log("user_name not found")
这些只能靠 Ctrl+Shift+F 全局搜索，尤其改公共 API 名称时，漏一个字符串可能引发线上故障。
重构菜单和细粒度操作怎么配才不翻车
Ctrl+Shift+R 默认无绑定，网上说它能“一键重构”纯属误导。真要用它唤出菜单，得手动配置：
- 打开快捷键设置：
Ctrl+K Ctrl+S - 搜索
editor.action.refactor，双击绑定到Ctrl+Shift+R - 务必加
when条件：editorHasCodeActionsProvider && editorTextFocus，否则光标在空白处也会弹窗 - 注意：
editor.action.refactor只弹菜单，不自动执行；真正可用的快捷键是：Ctrl+.（唤灯泡）、Ctrl+K Ctrl+X（提取变量）、Ctrl+K Ctrl+M（提取函数）
跨文件重命名看似一键，实则每一步都卡在语言服务的准备状态上——配置没到位、跳转不生效、AST 没建好，F2 就只是个摆设。
