CodeGeeX批量改代码教程

如果你正为项目中几十个文件里散落的 fetchUser() 而烦恼，希望全部替换为 getUserV2()，又不想手动逐个打开、查找、替换、保存，那么 CodeGeeX 的语义级批量替换功能正好可以派上用场。它依靠精准识别函数调用，而非简单的字符串匹配——像注释中的 // fetchUser() 或字符串内的 'fetchUser()' 都不会被误伤，省心省力。

用语义搜索一键替换全项目过时 API

这一功能依赖 AST 分析，而非简单的文本搜索“fetchUser”。因此，无论是 await fetchUser(id)、fetchUser ( )，还是 const u = fetchUser;，都能被正确识别为真正的调用点，而不会误伤变量名。

操作方式也很直观：按 Ctrl+Shift+P 打开命令面板，输入并选择“CodeGeeX: Semantic Search”，然后在弹出的搜索框中输入自然语言指令——例如“将所有调用 fetchUser 的地方改为 getUserV2，保留原有参数和括号结构”。回车后稍等片刻，分析结果便会显示出来。

预览面板会列出所有匹配位置，每行显示原代码和替换后的代码。值得留意的是，那些带注释的调用（如 // fetchUser()）或字符串中的假调用（如 'fetchUser()'）会不会被遗漏？CodeGeeX 默认排除这两类情况，因此基本不必担心误改。

如果只想单独应用某处替换，点击该行右侧的 图标即可；如果想一次性完成，直接点击顶部的“Apply All”按钮。

替换完成后，VSCode 编辑器标签页的标题上会出现一个 ● 圆点，表示有未保存的更改。注意：必须手动按 Ctrl+S 保存所有已修改的文件——CodeGeeX 不会自动写入磁盘，这一步若遗漏，Git 那边将看不到任何变更。

在单个文件内快速覆盖所有废弃调用

如果你只关心当前正在编辑的文件，并且希望立刻看到全部变更效果，右键菜单是最直接的入口。

右键点击编辑器的标签页，选择“CodeGeeX: Replace All Deprecated in This File”，弹窗会列出本次将修改的 3 到 12 处变更。确认无误后点击“Apply”，整个文件将被重写。

务必先提交当前文件的 Git 快照——这个操作不可撤销，重写后的内容无法通过 Ctrl+Z 恢复原始版本。

光标悬停精准替换单个废弃函数

有时候你只想改动一处，但不确定推荐的替代方案是什么，或者想边看边确认参数变化。这种场景下，光标悬停功能就特别顺手。

将光标悬停在被标记为 deprecated 的函数名上，按 Alt+Enter（Windows 和 macOS 均适用），选择“Replace with recommended alternative”，确认后新调用会自动插入，旧参数也会被清理干净——例如那些已经移除的 callback 参数，会被彻底清除。