VSCode重构能力依赖语言服务支持，非自身提供；需确认语言服务器激活、配置正确（如tsconfig.json）、作用域安全及测试覆盖。
VSCode 本身不提供深度重构能力，所谓“重构工具”实际依赖 TypeScript 语言服务或 Python、Java 等扩展的后端支持；直接调用 Refactor 菜单里的选项，可能失败、不生效，或只改了局部——关键不在 VSCode，而在你项目是否具备对应语言的服务支撑。
确认当前文件是否被语言服务器真正接管
重构功能是否可用，第一道门槛是语言服务是否激活。比如 TypeScript 文件没配 tsconfig.json，或路径不在 include 列表里，Extract to function 就会灰掉；Python 文件若没装 Pylance 或 Python 扩展，右键根本不会出现 Refactor 子菜单。
- 打开命令面板（
Ctrl+Shift+P/Cmd+Shift+P），输入Developer: Toggle Developer Tools，切到 Console 标签，看有无Failed to activate language server类报错 - 在编辑器右下角检查语言模式是否正确（如显示 “TypeScript React”，而非 “Plain Text”）
- 对 JS/TS 项目，确保根目录有
tsconfig.json或jsconfig.json；哪怕空文件也比没有强
提取函数（Extract Function）为什么有时只改调用、不改原逻辑？
这是最常踩的坑：你选中几行代码 → 右键 → Refactor… → Extract to function，结果新函数生成了，但原位置代码没被替换成函数调用——本质是 VSCode 不敢自动替换，因为无法 100% 推断作用域和副作用。
- 选中的代码不能含
return、break、continue或throw（除非在函数体内） - 不能跨作用域访问未声明变量；若用了外部
let变量，提取后会自动加参数，但若该变量在块外被重赋值，就可能出错 - React 函数组件内，选中 JSX 片段时，
Extract to component更可靠；而纯Extract to function可能生成非 JSX 返回值，导致渲染异常
重命名（Rename Symbol）在跨文件时为何失效？
F2 重命名看似简单，但在 JS/TS 中容易漏改：默认只作用于当前文件，除非你项目配置了完整的类型检查环境。
- 确保
"compilerOptions": { "composite": true }或启用"include"覆盖所有源码路径 - JS 项目需开启
jsconfig.json并设"checkJs": true，否则重命名不会跳转到.js文件中的引用 - 若重命名后某处没变，手动打开那个文件，光标停在符号上，看状态栏是否显示 “No definition found” —— 是的话，说明语言服务根本没索引它
别依赖“安全”二字，重构前必须做三件事
VSCode 的重构不是原子操作，也没有回滚快照。所谓“安全”，是你自己构建的安全网。
- 提交当前变更（
git commit -m "before refactor"），别只靠Ctrl+Z - 运行测试（哪怕只有 1 个单元测试），确认核心路径仍通过；没测试？至少手动触发一次相关逻辑
- 对大型提取，先用
Extract to constant拆一步，再Extract to function，比一步到位更可控
真正决定重构成败的，从来不是快捷键多顺滑，而是你有没有让语言服务看清整个项目结构，以及愿不愿意为一次重命名多按两次 git 命令。
