Refactor菜单为空主因是语言服务器未就绪；需确认状态栏显示TypeScript/JavaScript/Python、F12能跳转定义、tsconfig.json或pyproject.toml存在，且光标位于函数名首字符或选中合法语句块。
Refactor 菜单为空？先确认语言服务器是否真就绪
VSCode 本身不提供语义级重构能力，右键菜单里没有 “Extract to function” 或 “Encapsulate field”，大概率不是插件少，而是 TypeScript/JavaScript/Python 的语言服务器（LSP）压根没跑起来。菜单空着，本质是没注册任何 code action provider。
快速验证三步：
- 看右下角状态栏：必须显示
TypeScript、JavaScript或Python，不能是Plain Text或JavaScript React - 在函数名上按
F12：跳不到定义 → LSP 未加载；能跳转但 Ctrl+. 没重构项 → 可能配置缺失（如 TS 项目缺tsconfig.json，Python 项目缺pyproject.toml） - 打开开发者工具（
Ctrl+Shift+P→Developer: Toggle Developer Tools），查 Console 是否有language client is not ready、Pylance initialization failed或typescript-language-server crashed
右键菜单整体消失？用 Extension Bisect 快速定位冲突插件
如果右键连 “Open in Terminal”、“Copy Path” 都没了，只剩基础系统菜单，说明某个插件劫持或阻断了上下文菜单注册流程。这不是配置问题，是插件间注册冲突。
别手动禁用——用 VSCode 内置的二分排查工具：
- 执行
Ctrl+Shift+P→ 输入Developer: Start Extension Bisect回车 - 它会自动禁用一半插件，提示你“复现问题”（比如右键看菜单是否回来）
- 根据你答“是/否”，3–4 轮就能锁定唯一问题插件，例如
GitLens、Volar或某 AI 插件
特别注意：Language Server 类（如 rust-analyzer）、Git 增强类（如 GitLens）、AI 辅助类（如 CodeWhisperer）最常抢注 editor/context 贡献点，导致菜单项被覆盖或静默失败。
Ctrl+. 或 F2 不触发重构？检查光标位置和选区合法性
VSCode 的重构入口极度依赖上下文：不是快捷键绑错了，而是当前光标/选区根本不在支持范围内。
有效触发点只有三种：
- 光标停在函数名、变量名或类名的第一个字符上（如
getUserById，必须停在g上，停在erById上无效） - 精确选中一段语法合法、自包含的代码块：如
const result = a + b（不能带末尾分号）；return x * 2可以，但return x * 2;在 JS/TS 中常被拒绝 - 光标悬停在行首灯泡图标处（通常伴随 ESLint 或类型报错），按
Ctrl+.才会唤出对应 code action
常见失败原因：选中内容跨 if 块边界、含半个 for 循环、以 return 开头、或在未保存的临时文件里操作——LSP 不分析 unsaved 文件的跨文件引用，自然不提供安全重构选项。
手动绑定 Ctrl+Shift+R 后仍无效？when 条件必须加对
Ctrl+Shift+R 默认未绑定任何命令，很多人配了却没效果，是因为漏了关键的 when 条件。
正确配置必须包含两个约束：
-
editorHasCodeActionsProvider：确保当前文件类型有语言服务器支持重构（TypeScript有，JSON没有） -
editorTextFocus：防止焦点在搜索框或侧边栏时误触发
配置示例（写入 keybindings.json）：
[{
"key": "ctrl+shift+r",
"command": "editor.action.refactor",
"when": "editorHasCodeActionsProvider && editorTextFocus"
}]配完务必验证：打开一个 .ts 文件，光标停在函数名首字母，再按 Ctrl+Shift+R —— 应弹出含 Extract to function 和 Rename symbol 的菜单。若仍不生效，回开发者工具 Console 看是否报 No rename provider registered，那问题还在 LSP 层。
真正卡住重构的，往往不是功能开关，而是语言服务器是否完成初始化、项目配置文件是否存在、以及光标是否落在 LSP 能识别的符号声明点上。这些细节不满足，再多插件也白装。
