VSCode代码重构依赖语言服务器就绪、光标精准定位标识符首字符、选区语法合法且边界干净；重命名需文件被正确识别并配置tsconfig/jsconfig，提取函数须选连续可执行语句，快捷键优先用Ctrl+Shift+R或Cmd+Shift+R。
VSCode 的代码重构功能不是独立菜单，它藏在语言服务就绪后的上下文操作里——没配对语言支持、没选准范围、光标位置不对，它就直接隐身。
重命名（F2）为什么按了没反应？
根本原因不是快捷键失效，而是 VSCode 没法定位你要改的那个“符号”。它不靠字符串匹配，而依赖 TypeScript Server 或 Pylance 这类语言服务器（LSP）解析出的语法树。
- 光标必须落在标识符最左侧：比如
getUserById，停在erById上按F2会失败；用Ctrl+←跳到词首，或双击选中整个名字 - 文件得被正确识别：右下角状态栏显示
JavaScript或TypeScript，而不是Plain Text；后缀要是.js或.ts - 跨文件重命名要配置文件：TS 项目缺
tsconfig.json、JS 项目缺jsconfig.json，rename 基本只改当前文件，import 引用不会动 - 遇到 “No result” 或 “Found 0 references”，先打开命令面板运行
Developer: Toggle Developer Tools，看 Console 是否报No rename provider registered
Extract Function 快捷键触发不了？
它根本不响应“光标停在某行上”这种模糊操作——必须手动框出一段**语法合法、边界干净**的代码块，否则菜单灰掉或弹出 Cannot extract to function。
- 选中内容只能是连续可执行语句：比如
const result = a + b; return result * 2;可以；但console.log(x); // comment不行，注释会让 LSP 拒绝解析 - JS/TS 中别带末尾分号：选中
doSomething();会失败；改成doSomething()再试 - 不能跨作用域边界：在
if (x) { ... }里选一半大括号，或者从函数内部横跨到外部变量声明，都会中断语法连续性 - 快捷键优先用
Ctrl+Shift+R（Windows/Linux）或Cmd+Shift+R（macOS），比右键菜单更稳定；Ctrl+.是快速修复（Quick Fix），不是重构入口
提取常量（Extract Constant）生成位置反直觉？
VSCode 默认把 const API_URL = 'https://api.example.com'; 插到函数顶部，哪怕你是在 for 循环里选的字符串——这会导致常量作用域过大，且和使用位置脱节。
- 模板字符串（如
`/user/${id}`）无法直接提取：必须先手动简化成静态字符串，比如'/user/123'，再触发重构 - 数字/布尔字面量提取后无类型：TS 中
42提取为const MAX_RETRY = 42;，但不会加: number；只有原变量带类型注解（const count: number = 42），参数才带类型 - 更可控的做法：先手写
const XXX = ...;，再把光标放上去按F2重命名——这样位置、作用域、类型全由你控制
真正卡住人的从来不是功能有没有，而是语言服务是否就绪、光标是否落在语法树节点上、选区是否被 LSP 认定为“合法语句块”。这些细节不满足，VSCode 就当没看见你按下的快捷键。
