vscode的重构功能完全依赖语言服务器（lsp），而非内置引擎；f2重命名、ctrl+.唤出菜单、extract method等操作均需ts/js/python等语言服务就绪，右下角显示对应语言模式且ast构建成功方可生效。

VSCode 本身不提供自动重构引擎，所有真正安全、跨文件的重构行为，都依赖语言服务器（LSP）驱动。插件只是封装高频操作或补足 LSP 缺口——装一堆名字带“Auto”“Smart”的插件，大概率只是把 F2 包了一层壳，毫无额外价值。

Refactor 菜单为空？先确认 LSP 是否真正就位

右键没“重构”子菜单，或只有 Rename Symbol，不是插件少，而是语言服务没加载成功：

• 右下角状态栏看语言模式：必须显示 TypeScript、JavaScript 等，不能是 Plain Text 或 JavaScript React
• 在 .ts 文件中按 F12 测试能否跳转到定义；跳不到，F2 必然只做局部文本替换
• 打开开发者工具（Ctrl+Shift+P → Developer: Toggle Developer Tools），查 Console 是否报 gopls 连接失败、Pylance 初始化超时等错误
• TypeScript 项目必须有 tsconfig.json（哪怕空文件），且工作区根目录要对得上

Extract Function 失败的硬性条件

VSCode 不判断逻辑，只校验语法合法性。选中内容稍有偏差，就会直接报 "Cannot extract to function"：

Aria2 Json Rpc

通过 JSON‑RPC 2.0 与 aria2 下载管理器交互，使用自然语言命令管理下载、查询状态并控制任务。适用于 aria2、下载管理或种子操作。

下载

• 必须手动拖选连续可执行语句：不能含半个 if 块、不能跨函数边界、不能以 return 开头（顶层 return 会被忽略）
• JS/TS 中末尾分号会触发拒绝；Python 中未赋值的 let 变量无法推导参数
• 返回值仅取最后一条 return 表达式，前面的 console.log() 或副作用语句全被原样搬进新函数
• 提取后立刻检查签名：async 丢了没？count 这类外层 let 变量是否被当作参数传入？参数名是 arg0？别手敲——提取完光标自动停在第一个参数上，按 F2 即可重命名

JavaScript Booster 插件的真实能力边界

它不替代 LSP，但能绕过部分语法限制，提供轻量级、上下文感知的转换：

• 左侧黄色灯泡只对当前行或选中表达式生效，不跨作用域分析，比如不会帮你把 var str1 = 'jspang.com'; 改成 const 后，再顺手改掉所有 str1 的重新赋值
• Convert to arrow function 对具名函数有效，但对立即执行函数（IIFE）或方法简写（如 obj.method = function() {}）可能不触发
• Replace with template string 仅处理 + 拼接字符串，对 String.concat() 或 Array.join() 无响应
• 它不做类型检查，所以 Flip if-else 或 Replace with ?: 后，若原分支含副作用（如修改全局变量），插件不会警告，也不会自动提取为纯函数

真正容易被忽略的是：重构安全的前提不是插件多，而是语言服务是否完成 AST 构建。哪怕只用内置功能，只要 tsconfig.json 存在、文件保存、LSP 日志里没有 error，F2 和右键 Extract 就比任何“智能插件”更可靠。