Refactor菜单为空是因为LSP未就位：右下角语言模式必须为TypeScript/JavaScript而非Plain Text，F12无法跳转定义即LSP未加载，F2重命名将退化为文本替换。
Refactor菜单为空？先看右下角语言模式和LSP状态
VSCode本身不提供自动重构引擎，所有跨文件、语义级重构都依赖语言服务器（LSP）——不是插件装得多就管用。菜单里没“Refactor”选项，大概率是LSP根本没起来。
- 右下角状态栏必须显示
TypeScript或JavaScript，不能是Plain Text或JSON - 在
.js文件里按F12测试能否跳转到定义；跳不到，说明LSP未加载，F2重命名只会做文本替换 - 打开
Developer: Toggle Developer Tools，查Console有没有typescript-language-server启动失败、超时或路径错误 -
javascript.suggest.autoImports设为true能提升符号识别准确率，尤其对未显式导入的模块
Extract Function灰色不可用？检查选中范围是否语法合法
VSCode不分析逻辑，只校验AST合法性。哪怕只多一个分号、少一个花括号，就会报"Cannot extract to function"。
- 必须选中连续可执行语句：不能跨
if块边界，不能以return开头（顶层return会被忽略） - JS/TS中末尾带分号会直接拒绝；Python中未声明的
let变量无法推导参数类型 - 返回值只取最后一条
return表达式，前面的console.log()或副作用语句原样搬进新函数 - 提取后立刻检查：
async丢了没？外层count这类let变量是否被当作参数传入？参数名是arg0？别手敲——光标默认停在第一个参数上，按F2就能重命名
ESLint + Prettier 自动修复 ≠ 重构，顺序错就互相覆盖
editor.codeActionsOnSave和editor.formatOnSave不是并行触发，而是有执行优先级。顺序一错，分号可能被ESLint加上又被Prettier删掉。
- 先启用ESLint自动修复：
"eslint.run": "onSave"+"editor.codeActionsOnSave": { "source.fixAll.eslint": true } - 再启用格式化：
"editor.formatOnSave": true，且"editor.defaultFormatter": "esbenp.prettier-vscode" - 关键一步：禁用ESLint的格式规则，装
eslint-config-prettier并加到.eslintrc.js的extends最末尾 - Vue/TSX项目若用Volar，额外设
"volar.autoInsertDotValue": false，否则格式化会破坏ref().value写法
Ctrl+Shift+R没反应？它默认根本没绑定命令
Ctrl+Shift+R（Windows/Linux）或Cmd+Shift+R（macOS）在VSCode默认安装里是空快捷键，不是你按错了，是它本来就不干活。
- 查
Ctrl+K Ctrl+S打开快捷键面板，搜refactor会发现editor.action.refactor处于未绑定状态 - 手动绑定时必须加
when条件："editorHasCodeActionsProvider && editorTextFocus"，否则会在JSON或搜索框里误触发 - 即使绑定了，也得满足触发条件：光标必须落在函数名**第一个字符**上（比如
getUserById，停在g上才行），不能停在中间 - 选中代码块时，要精确——
const result = a + b;带分号就失败；return x * 2可以，但return x * 2;在TS里常被拒
实际重构时最容易被忽略的，是LSP是否真正就位——不是“插件装了”，而是typescript-language-server进程跑起来了、tsconfig.json路径对了、工作区根目录没搞错。很多“重构失败”本质是语言服务卡在初始化阶段，连基础符号索引都没建好。
