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 绑定、或未显式声明的全局引用识别不稳。
- 选中代码前，确保所有待提取逻辑中用到的变量都在当前作用域显式声明（避免隐式全局）
- 若函数内含
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。
