vscode本身不提供自动重构引擎，所有安全跨文件重构均依赖lsp驱动；refactor菜单为空需先确认lsp就位，f2重命名和extract function等操作必须基于正确配置的语言服务、保存文件及语法合法选中范围。
VSCode 本身不提供自动重构引擎，所有真正安全的跨文件重构都依赖语言服务器（LSP）——插件只是补位或封装，不是万能解药。
Refactor 菜单为空？先确认 LSP 是否就位
右键没“Refactor”子菜单，或只有 Rename Symbol，大概率不是插件没装，而是语言服务根本没跑起来：
- 右下角状态栏检查语言模式：必须显示
TypeScript或JavaScript React，不能是Plain Text - 在
.ts文件里按F12测试跳转定义；跳不到，说明 LSP 未加载，F2重命名就只是文本替换 - 打开开发者工具（
Ctrl+Shift+P→Developer: Toggle Developer Tools），看 Console 是否报gopls连接失败、Pylance初始化超时等错误 - TypeScript 项目必须有
tsconfig.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 自动修复：
"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，否则格式化会破坏.访问
重构真正卡住的地方，往往不是操作不会点，而是 LSP 没加载成功、选中范围不合法、或 ESLint/Prettier 规则打架——这些细节不排查清楚，装再多名字带 “Auto” 的插件也白搭。
前端入门到VUE实战笔记：立即使用
在学习笔记中，你将探索 前端 的入门与实战技巧！
