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。
- 必须手动框选：不能只把光标放在行首按快捷键，得用鼠标或
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 就只在已保存文件里跑，引用漏掉是常态。别等出问题才想起来保存。
