f2重命名能跨文件更新的前提是语言服务已就位，否则退化为易出错的文本替换；只改局部是因为lsp未正确构建语义图谱，常见原因包括状态栏显示plain text、缺失tsconfig.json/jsconfig.json或未启用pylance等。

F2 重命名能跨文件更新，但前提是语言服务已就位；否则只是文本替换，极易出错。

重命名符号（rename symbol）为什么有时只改了局部？

VS Code 的 rename symbol 不是全文搜索替换，它依赖语言服务器（LSP）构建的语义图谱。如果项目没正确配置，你按 F2 后看到的“重命名”选项可能灰掉，或只在当前文件生效。

• 检查右下角状态栏语言模式是否为 TypeScript、JavaScript 或 Python，不是 Plain Text
• TypeScript/JS 项目必须有 tsconfig.json 或 jsconfig.json，且含 "include": ["**/*"] 等通配配置
• Python 需启用 Pylance 扩展（非仅 Python 官方扩展），并在设置中确认 python.languageServer 设为 Pylance
• 重启 VS Code 后首次重命名稍慢属正常，但若持续失败，大概率是 LSP 未加载成功——打开开发者工具（Ctrl+Shift+P → Developer: Toggle Developer Tools）看 Console 是否报 Failed to start language server

提取函数（Extract to Function）后参数乱序或漏传？

VS Code 内置的提取功能会自动推导变量作用域和依赖项，但对闭包外的自由变量、this 绑定、或未显式声明的全局引用识别不稳。

VSCode

避免常见的 VSCode 错误——设置冲突、调试器配置和扩展冲突。

下载

• 选中代码前，确保所有待提取逻辑中用到的变量都在当前作用域显式声明（避免隐式全局）
• 若函数内含 async / await，提取后默认不加 async 修饰符，需手动补上
• React 中提取 JSX 片段时，useState 或 useEffect 相关逻辑不能直接提取——建议用 Glean 或 React Refactor 插件替代
• 提取后立即运行 Find All References（Shift+F12）确认新函数被正确调用，避免因参数名冲突导致静默覆盖

自动导入（Auto import）总提示“未找到模块”？

自动导入依赖路径解析能力，而 VS Code 默认只认相对路径和 node_modules。一旦用了 @/ 别名或自定义 baseUrl，就必须显式告知语言服务。

• jsconfig.json 或 tsconfig.json 必须放在项目根目录，且 baseUrl 值只能是 "."（不能是 "./" 或空字符串）
• paths 配置中 key 必须以 / 结尾，如 "@/*": ["src/*"]，写成 "@/*": ["src"] 将失效
• 改完配置后执行 Developer: Reload Window，否则语言服务仍用旧缓存
• 若仍不生效，临时禁用其他路径类插件（如 Path Intellisense），排除干扰

AI 类重构（Copilot / Tabnine）建议不可直接提交

AI 工具能快速生成“看起来合理”的重构方案，但它无法感知项目真实约束：已有测试覆盖率、运行时环境限制、团队约定的抽象层级、甚至某处 try/catch 是为兼容旧版浏览器留的兜底。

• Copilot 输入指令越具体越好，例如写“把这段 Promise.all + map 替换为 for await…of，保留错误聚合逻辑”，比“优化这个异步代码”可靠十倍
• 所有 AI 生成的代码，必须手动检查三处：边界条件是否覆盖、await 是否遗漏、新增依赖是否已在 package.json 中声明
• 敏感项目建议关闭 Copilot 的 telemetry，并优先试用 CodeWhisperer（AWS 提供，支持离线模式）或本地模型（如 Ollama + Cody）
• 重构前务必 git commit -m "refactor: prepare for X"，应用 AI 建议后立刻 git diff 对比，别跳过这一步

真正卡住重构进度的，往往不是功能缺失，而是语言服务未就绪时误信“重命名已生效”，或是 AI 建议里藏了一个没声明的 import 却没被发现——这些点不显眼，但一出问题就是 runtime error。