VSCode重命名和提取函数能力源自语言服务器（LSP）而非插件；TypeScript需tsconfig.json、JavaScript需jsconfig.json、Python需Pylance+pyproject.toml等配置，否则F2仅局部替换或Extract Function失效；所有操作前须保存文件。
VSCode 本身不依赖插件提供重命名和提取函数能力，这些是语言服务器（LSP）的原生功能；装错语言支持或配置缺失，F2 和 Extract Function 就会失效或只改局部。
重命名符号（F2）为什么只改了当前文件？
根本原因不是插件没装，而是语言服务器没识别出跨文件引用关系。TypeScript 项目必须有 tsconfig.json，JavaScript 项目需 jsconfig.json（尤其用了路径别名时），Python 项目得靠 Pylance + pyproject.toml 或 pyrightconfig.json 声明模块结构。
- 按下
F2后光标没变可编辑状态？右下角看是否有 “Loading Pylance…” 或 “TypeScript initializing…” —— 等它完成再试 - 重命名后
import路径没更新？先运行命令面板里的Restart TS Server，再确认tsconfig.json是否在工作区根目录 - 光标停在
obj.name上按F2，只改了属性访问，不改对象字面量里的name:—— 必须双击选中整个name:键名才能同步
Extract Function 提取后参数乱、返回值错怎么办？
VSCode 不做逻辑判断，只按语法树推导：它把选中块里最后一条 return 当返回值，把所有被读取的外部变量当参数，但不会自动处理闭包捕获的 let 变量或异步上下文。
- 必须选中**连续可执行语句**：不能含半个
if、不能跨函数边界、不能以return开头（顶层return会被忽略） - 若选中代码含
console.log()+return x;，新函数会保留日志，但调用处只接收x—— 副作用没消失，只是挪了位置 - 提取后立刻检查函数签名：是否漏了
async？参数名是否该解构？count这类外层let变量是否被当作参数传入？
哪些“重构”真要靠插件，哪些纯属白装？
真正能补足 VSCode 原生短板的只有少数几个：ESLint 提供基于规则的自动修复（比如把 var 改 const），Prettier 保证格式不干扰语义，TypeScript Refactoring 扩展加了 “提取接口”“内联类型” 等高级项；而名字带 “Auto Refactor”“Smart Rename” 的通用插件，基本只是包装 F2，毫无额外价值。
- Python 项目想提取方法到类外？原生
Extract Function只支持类内 —— 得靠ropeCLI 配合tasks.json调用 - 想把一个函数拆成 Strategy 模式？VSCode 不理解设计意图，这类重构必须手动+测试保障
- 安装了 ESLint 但
Ctrl+.没反应？检查当前文件是否有诊断报错，且eslint.enable已开启
最常被忽略的一点：所有 LSP 重构操作都要求文件已保存。没保存的修改，语言服务器看不到 AST 更新，F2 和 Extract Function 都会退化为文本替换 —— 重构前按一下 Ctrl+S，不是仪式感，是必要前提。
