F2是VSCode中语义级重命名的唯一可靠快捷键，右键“Rename Symbol”仅是UI入口，二者均依赖语言服务器；若服务未就绪、文件未保存、光标位置错误或配置缺失（如tsconfig.json/pyproject.toml），则F2和右键均失效，表现为无响应、仅局部修改或弹窗一闪而过。
F2 是重命名的唯一可靠入口，右键菜单只是备用路径
VSCode 中真正触发语义级重命名的是 F2，不是右键菜单里的“Rename Symbol”。右键选项只是 UI 层的快捷入口，背后仍走同一套语言服务器逻辑。一旦语言服务未就绪，右键点击会直接失效——你看到菜单项灰掉、点完没反应、或只做全文本替换，都不是菜单本身的问题，而是符号未被解析。
常见错误现象：
- 右键弹出菜单但“Rename Symbol”不可点击
- 点了之后弹窗一闪而过，光标跳转到定义处却没输入框
- 改完名称，只更新了当前文件，跨文件引用完全没动
这些都说明：语言服务器没接管该符号。此时按 F2 也一样无效，别浪费时间调右键菜单。
右键菜单失效的三个硬性前提条件
右键能正常唤出并执行重命名，必须同时满足：
- 文件已保存，且后缀被识别为支持语言（如
.ts、.py、.js），状态栏右下角显示对应语言名，不是Plain Text - 光标落在可重命名的符号上：必须是变量声明（
const userName中的userName）、函数名（function getUser()的getUser）或显式引用（console.log(userName)中的userName），不能停在字符串或注释里 - 对应语言扩展已启用且语言服务器运行中：Python 需
Pylance，TypeScript/JS 依赖内置 TS 服务，Java 需Extension Pack for Java
缺一不可。比如你打开一个未保存的 .py 文件，右键菜单可能显示“Rename Symbol”，但点击后无响应——因为 Pylance 只对已保存文件建立 AST 索引。
Ctrl+. 唤出重构菜单比右键更稳定
当右键菜单缺失或响应异常时，Ctrl+.（Windows/Linux）或 Cmd+.（macOS）是更可靠的替代方案。它不依赖鼠标悬停位置，只要光标落在符号上或选中代码块，就能拉出上下文感知的重构列表。
这个快捷键触发的是语言服务器返回的 CodeAction，包含：
-
Rename Symbol（等效于F2） -
Extract to function（需选中表达式） Extract to constant- 其他扩展提供的操作（如
typescript-hero的内联类型）
注意：Ctrl+Shift+R 在原生 VSCode 中无绑定，网上教程说它能提取函数，基本是混淆了旧版插件或自定义 keybinding。别试，它不会有任何反应。
跨文件重命名失败？检查 import/export 模式
你对 from api import get_user 中的 get_user 右键重命名，结果只改了当前文件，api.py 里的 def get_user() 没变——这不是 bug，是设计行为。
VSCode 默认只重命名“导入名”，不联动修改“定义名”，除非满足两个条件：
- 定义端必须是具名导出：
export function get_user()，不能是export default function() - 导入端必须是具名导入：
import { get_user }，不能是import api from 'api'; api.get_user()
否则语言服务器无法建立跨文件符号映射，右键/F2 都只能做局部文本替换。这点极易被忽略，也是重命名后 import 行不变却误以为“漏改”的主因。
