vscode本身不提供自动重构引擎，所有安全跨文件重构均依赖lsp驱动；refactor菜单为空需先确认lsp就位，f2重命名和extract function等操作必须基于正确配置的语言服务、保存文件及语法合法选中范围。
VSCode 本身不提供自动重构引擎，所有真正安全的跨文件重构都依赖语言服务器（LSP）——插件只是封装或补位，不是魔法。 装一堆“Auto Refactor”类插件，大概率只把 F2 或右键菜单包了一层，没解决根本问题。想让重构可靠，得先让 LSP 真正跑起来。
Refactor 菜单为空？先查 LSP 是否就位
右键没“Refactor”子菜单，或只有 Rename Symbol，不是插件没装全，而是语言服务没加载成功：
- 右下角状态栏看语言模式：必须显示
TypeScript、Python、Java等，不能是Plain Text或JavaScript React - 在
.ts文件中按F12测试能否跳转到定义；跳不到，F2就只会做文本替换 - 打开开发者工具（
Ctrl+Shift+P→Developer: Toggle Developer Tools），查 Console 是否报gopls连接失败、Pylance初始化超时等错误 - TypeScript 项目必须有
tsconfig.json（哪怕空文件），且工作区根目录要对得上；Python 项目需pyproject.toml或pyrightconfig.json启用类型检查
Extract Function 失败？选中范围必须严格合法
VSCode 不判断逻辑，只校验语法合法性。稍有偏差就直接报 "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，否则格式化会破坏.访问链
Glean / React Refactor 类插件真正在哪起作用？
这类插件不替代 LSP，而是在 LSP 提供基础能力后，针对框架特有结构做增强：
-
Glean的Extract Component会自动识别 JSX 中用到的 props，并生成带import/export的完整组件文件——但前提是当前文件已被识别为React或TSX，且 LSP 已就位 -
React Refactor的类→函数组件转换，依赖 TypeScript 类型信息推导state和props，若tsconfig.json缺失或node_modules没装全，setState映射就会出错 - 状态变量重命名（如
const [loading, setLoading] = useState(false)）能同步更新setLoading，靠的是插件监听 LSP 返回的符号引用链，不是字符串匹配
最常被忽略的点：重构操作的可靠性不取决于插件数量，而取决于 LSP 初始化完成后的 AST 解析质量。哪怕只装了官方语言扩展，只要 tsconfig.json 存在、F12 能跳转、状态栏显示正确语言模式，F2 和右键 Extract Function 就已足够可靠。其余插件，只是在此基础上做“省一步”的封装。
