vscode的“智能重构”依赖语言服务器（lsp）基于ast执行语义安全操作，如shift+f6重命名、ctrl+shift+r提取函数等，需文件已保存、lsp就绪且配置正确（如tsconfig.json、moduleresolution），否则功能失效。

VSCode 的“智能重构”不是 AI 自动生成新架构，而是语言服务器（LSP）基于 AST 对已有代码做语义安全的结构调整——它不帮你设计模式，但能稳准快地执行 rename、extract、inline 等动作。前提是你得让 LSP 正常工作，否则所有快捷键都只是摆设。

重命名必须用 Shift+F6，F2 在多数项目里不可靠

Shift+F6 强制调用语言服务器的 textDocument/rename 接口；F2 在某些配置下会退化为简单文本替换，尤其在未识别为 TypeScript/JavaScript 项目时。

• 光标必须停在符号**定义处**：比如 function fetchData() 的 fetchData 上，而不是某处 fetchData() 调用上
• 文件必须已保存，且语言服务已就绪：右下角看到 “TypeScript Server ready” 或 “Pylance loaded” 才算真正可用
• 跨文件重命名失效？检查项目根目录是否有 tsconfig.json（TS）或 jsconfig.json（JS），缺一不可
• import 路径没更新？不是 bug，是模块解析未启用——确认 tsconfig.json 中 "moduleResolution": "node" 已设置

Extract Function 要求选中“可独立封装的语句块”，不是“你认为逻辑上该抽”

VS Code 不分析控制流或副作用，只校验语法合法性与变量可见性。选错范围，直接报 Cannot extract to function。

VSCode

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

下载

• 必须手动框选：不能只把光标放在行首按快捷键，得用鼠标或 Shift + ↓ 明确选中完整语句（含 const 声明、return、无多余分号）
• 想带参数？选中部分必须包含所有待传入变量的声明，例如：const a = 1; const b = 2; return a + b; —— 少一个 const，生成函数就没参数
• 含 this、await 或闭包变量？Copilot 生成的版本大概率崩，得手动补 async、加参数、处理绑定
• Python 提取仅支持类内方法（Refactor > Extract method），顶层表达式要用 Pylance 的 Extract to constant 替代

Ctrl+. 不是万能重构入口，它只响应当前行诊断

Ctrl+. 触发的是 Quick Fix，不是 Refactor。它只对有诊断信息（如 ESLint 报错、TS 类型错误）的行生效，和重命名、提取完全无关。

• 想调出重命名/提取菜单，请用 Ctrl+Shift+R（Windows/Linux）或 Cmd+Shift+R（Mac）
• 右键菜单里的 “Refactor” 子项是否为空？说明当前语言服务器未实现对应 codeAction，比如 Rust 默认不支持 Extract Function
• Python 文件右键没重构选项？确认已安装 Pylance，且状态栏显示语言模式为 Python，不是 Plain Text
• TS 项目里 Ctrl+. 只提示 “Add missing import”，却没 “Extract to function”？检查 tsconfig.json 是否被 exclude 掉，或是否在 symlink 目录下导致路径解析失败

最易被忽略的一点：所有 LSP 重构默认跳过未保存文件。改了一半代码没 Ctrl+S，rename 就只在已保存文件里跑，引用漏掉是常态。别等出问题才想起来保存。