vscode本身不提供自动重构引擎，所有安全跨文件重构均依赖lsp驱动；refactor菜单为空需先确认lsp就位，f2重命名和extract function等操作必须基于正确配置的语言服务、保存文件及语法合法选中范围。

VSCode 本身不提供“自动重构引擎”，所谓插件辅助的自动重构，本质是补足语言服务器（LSP）能力缺口或封装高频操作——但所有安全、跨文件的语义级重构，仍必须由 LSP 驱动。装一堆名字带“Auto”“Smart”的插件，大概率只是把 F2 包了一层壳，毫无额外价值。

Refactor 菜单为空？先确认 LSP 是否真正就位

右键没“重构”子菜单，或只有 Rename Symbol，不是插件少，而是语言服务没加载成功：

• 右下角状态栏看语言模式：必须显示 TypeScript、Python 等，不能是 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"：

VSCode

避免常见的 VSCode 错误——设置冲突、调试器配置和扩展冲突。

下载

• 必须手动拖选连续可执行语句：不能含半个 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，否则格式化会破坏响应式语法

AI 插件（Copilot/Tabnine）只能当草稿机，不能当执行器

选中代码按 Ctrl+Enter 让 Copilot “转成 async/await”，它不理解作用域、不校验类型、不更新 import：

• 不会检查 fetch 是否已声明，也不会把 require('fs') 改成 import fs from 'fs'
• 对 Python 的 self.xxx 成员变量重命名，AI 建议可能漏掉 @property setter 中的同名引用
• 真正安全的重命名只有一条路径：F2 → LSP 返回全部引用位置 → VSCode 批量编辑
• 如果项目没 tsconfig.json 或 pyrightconfig.json，连 LSP 都起不来，此时 AI 建议更不可信

所有基于 LSP 的重构都默认跳过未保存的文件。改了一半没 Ctrl+S，Rename Symbol 就只在已保存文件中生效，引用直接丢失——这个前提，90% 的人会在第一次出问题时才意识到。