CodeGeex 可自动识别并替换项目中已废弃的 API：需先启用上下文感知模式，再执行扫描命令，最后通过悬停替换、文件级覆盖或跨模块迁移三种方式安全更新。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
在开发中快速定位并替换项目里已废弃的 API，避免运行时警告或功能失效，CodeGeex 可以基于代码语义理解自动识别过时调用并生成安全等效替换。你不需要逐个翻查文档，也不依赖 IDE 的有限提示能力。
配置 CodeGeex 插件并启用上下文感知模式
打开 VS Code → 扩展市场搜索「CodeGeex」→ 点击安装 → 重启编辑器后点击左下角齿轮图标 → 选择「Settings」→ 搜索「codegeex.context」→ 勾选「Enable Context-Aware Code Understanding」。【必须开启此项，否则无法识别 API 废弃状态】
这一步启用后，CodeGeex 会主动读取当前文件所在项目的 package.json、tsconfig.json 和 node_modules 中的类型声明，构建 API 使用图谱。
扫描整个工程中所有废弃 API 调用
按下 Ctrl+Shift+P（Windows/Linux）或 Cmd+Shift+P（macOS）→ 输入「CodeGeex: Scan Deprecated APIs」→ 回车执行。
扫描过程耗时取决于项目规模，中型 React + TypeScript 项目约需 8～25 秒；期间不要关闭终端面板，否则中断后需重新触发。扫描结果以悬浮列表形式显示在编辑器右侧，每条含：原调用位置、废弃版本、推荐替代项、迁移说明链接。
批量替换废弃 API 的三种方式
方法一：单点精准替换
将光标悬停在被标记为「deprecated」的函数名上 → 按 Alt+Enter（Windows/macOS 均适用）→ 选择「Replace with recommended alternative」→ 确认后自动插入新调用并删除旧参数（如已移除的 callback 参数会被彻底清除）。
方法二：文件级批量覆盖
右键点击编辑器标签页 → 选择「CodeGeex: Replace All Deprecated in This File」→ 弹窗列出本次将修改的 3～12 处变更 → 点击「Apply」后立即重写整个文件。注意：该操作不可撤销，【务必确保已提交当前文件的 Git 快照】
方法三：跨模块智能迁移
- 在资源管理器中框选 src/utils、src/api、src/hooks 三个文件夹 → 右键 → 「CodeGeex: Batch Migrate Deprecated APIs」
- 等待分析完成（进度条显示「Resolving dependency-aware replacements」）
- 查看预览窗口中的「Conflicting replacements」区块——这里会标出因类型不兼容而无法直替的位置，例如 useState 第二个参数从数组变为对象时需手动调整解构逻辑
- 勾选确认无冲突的条目 → 点击「Execute Migration」
