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 中容易漏改：默认只作用于当前文件，除非你项目配置了完整的类型检查环境。

Python Dependency Candidate Fetcher 2

根据包的能力以及 Jupyter 环境中的导入语句，从候选列表中挑选最适合用户表格工作流的 Python 包。

下载

• 确保 "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 命令。