F2重命名只改当前文件的根本原因是语言服务未构建完整模块图，需项目根目录存在jsconfig.json或tsconfig.json、右下角显示正确语言模式、光标落在符号内部且配置覆盖关键路径。
VSCode 的重构和 Quick Fix 功能不是“开箱即用”的魔法，它们是否生效、修得对不对，取决于语言服务是否真正加载、配置是否覆盖关键路径、以及你操作的代码是否在语义分析范围内——缺一不可。
为什么 F2 重命名只改当前文件？
根本原因不是插件没装，而是 VSCode 没拿到完整的模块图。它默认把单个 JS/TS 文件当独立单元处理，跨文件引用压根不分析。
- 检查项目根目录是否存在
jsconfig.json（JS）或tsconfig.json（TS），哪怕空文件也必须存在 - Webpack 别名（如
@/utils）必须在jsconfig.json的"compilerOptions": { "baseUrl": ".", "paths": { "@/*": ["src/*"] } }中显式声明，否则重命名时完全看不到别名路径下的引用 -
require('utils')[funcName]或import(...)动态调用，任何语言服务都识别不了——F2 不会动，只能靠Ctrl+Shift+F搜字符串 + 手动验证
Quick Fix 灯泡图标不出现或选项为空？
灯泡是诊断（diagnostics）的可视化出口，没灯泡 = 没诊断 = 语言服务没跑起来，或当前文件被当成纯文本。
- 右下角状态栏确认语言模式是
JavaScript、TypeScript等，不是Plain Text；点击可手动切换 - 打开
Developer: Toggle Developer Tools，看 Console 是否有Failed to start language server或Cannot resolve provider -
editor.quickSuggestions必须为true（默认开启，但可能被 workspace 设置覆盖） - 快捷键
Ctrl+.（Win/Linux）或Cmd+.（macOS）常被中文输入法吞掉，先关输入法再试；也可右键 → “Quick Fix…” 手动唤出验证功能是否正常
Extract Method 抽出来全是 any 参数？
这不是 VSCode 抽错了，是它没足够信息推导类型——原始上下文里变量没类型标注、用了闭包或 this、或者选中范围漏了依赖声明。
- 抽之前确保关键变量带明确类型，比如
const price: number = 100;，而非let price = 100; - 不要只选
tax * discount，要把const tax = ...和const discount = ...一起框住 - 含
this或闭包变量的代码块，VSCode 默认不自动提为参数，生成后需手动补签名，或改用 Copilot 的/extract指令获取带上下文建议 - 若项目无
tsconfig.json，Extract 操作会退化为纯文本替换，连基本作用域判断都失效
移动文件后 import 路径全红，怎么批量修复？
VSCode 原生不支持自动更新 import 路径——这是硬伤。手动改极易漏、大小写错、路径拼错，尤其在大型项目里。
- 装
JavaScript Refactor（作者 micnic），它会在你用内置“Move to new file”操作后，自动触发Update imports for moved file - 禁用其他同类型插件（如旧版
Auto Import），它们常与 LSP 冲突，导致重命名卡死或 Quick Fix 失效 - 移动前先运行
Find All References（Shift+F12），确认所有调用点都在索引范围内；若漏结果，检查tsconfig.json的"include"是否覆盖全部源码路径
最危险的不是功能不出现，而是它“看似成功”——比如重命名改了 95% 的引用，剩下 5% 在 eval、模板字符串或 Webpack require.context 里，毫无提示。这类地方只能靠 grep -r + 测试覆盖率兜底，没有捷径。
