你是否也遇到过那种年代久远、写法混杂、嵌套层级深到让人头疼的老项目代码？比如 jQuery 事件绑定、用 var 声明的旧变量、杂乱无章的 CSS 类名，或者一个 Ja va 类中同时塞进了用户、订单、商品三类业务逻辑。若想手动逐行升级，效率往往非常低；如果只凭经验判断，又容易带来额外风险。这种情况下，CodeGeeX 的智能重构功能或许就是更高效的解决方案。

CodeGeeX v3.2.0 及以上版本支持三类更智能的代码重构能力：jQuery 到 ES6 的迁移、CSS 冗余清理、以及Ja va 单体应用按业务领域拆分。这里所说的“有脑”重构，重点在于它能够结合上下文理解代码意图，而不是单纯按固定模板机械替换。

VS Code 中用快捷键触发智能重构

将光标放到你准备重构的函数体中，无需提前选中整段代码。然后按下 【Ctrl+Alt+R】（Windows/Linux）或 【Cmd+Option+R】（macOS）。如果默认快捷键发生冲突，也可以在键盘快捷方式设置中搜索“codegeex.refactor”，重新绑定一个更合适的组合键。

打开的侧边栏通常会展示 2 到 4 条重构建议，例如“提取重复逻辑为独立函数”、“简化多层三元表达式嵌套”、“将含义模糊的变量重命名为语义化名称”。这些建议并不是固定不变的通用列表，而是针对当前光标所在代码块实时生成的上下文重构方案，并附带相应解释。每条建议下方还会显示 diff 预览：绿色表示新增，红色表示删除，灰色表示保留。点击任意建议右侧的“✅ Apply”后，VS Code 会自动完成编辑，并高亮显示变更区域。整个操作过程流畅自然，更像是在使用一款真正懂代码的智能编辑器。

用自然语言注释精准控制重构方向

如果通过快捷键得到的通用重构建议还不够精确，你可以在目标代码块上方补充一行清晰的自然语言注释指令。例如：
// 将此 jQuery 事件绑定和 DOM 操作重构为纯 ES6：使用 addEventListener、fetch 替代 $.ajax、用 const/let 声明、箭头函数、解构赋值

将光标移动到注释正下方，按下 【Alt+】（Windows/Linux）或 【Option+】（Mac），然后等待 AI 生成重构建议。这一步非常关键——如果你只是直接选中代码并右键点击“Refactor Code”，系统通常只会执行通用层面的简化，无法准确理解 jQuery 到原生 JavaScript API 的映射关系。自然语言注释中的明确指令，才是帮助 AI 精准识别重构目标的重要前提。

需要注意的是：必须使用 CodeGeeX v3.2.0 或更高版本，旧版本并不支持这类语义识别和上下文感知式重构。

重构前必须完成的三项准备

第一，确认插件已经正确安装并可用。打开 VS Code 扩展市场（Ctrl+Shift+X），搜索“CodeGeeX”并点击安装。安装完成后建议重启编辑器，只有当右下角状态栏出现“CodeGeeX Ready”提示时，才说明插件已经成功激活。

第二，保证网络连接稳定。CodeGeeX 插件在运行时需要联网，首次使用还会自动下载一个轻量级本地模型，整个过程大约需要 15 到 40 秒，在此期间不要关闭 VS Code 窗口。

第三，检查文件编码和命名规范。CSS 文件必须保存为 UTF-8 编码（BOM 关闭），文件名中不要包含中文或空格，例如 styles_v1.css；Ja va 文件则要确保不存在语法错误，否则在解析阶段就可能失败，导致智能重构中断。

按类型选择重构路径

方法一：jQuery → ES6+
适用于老旧项目中大量存在 $('.btn').click(...) 或 $.ajax 调用的场景。推荐操作路径：先添加注释指令 → 再按 Alt+ 触发建议 → 最后分步骤验证事件绑定、fetch 封装、DOM 操作以及变量声明是否已安全转换。

方法二：CSS 冗余清理
适用于样式表中存在被覆盖、未使用或特异性冲突的选择器。推荐操作路径：在文件顶部添加 // @codegeex: analyze redundancy + preserve specificity chain → 提交到 Web Playground → 使用 codegeex-4-css 模型进行分析 → 输出 [REMOVED] .old-header { } → [REPLACED] .header { } 这类格式化结果。

方法三：Ja va 单体 → 微服务拆分
适用于 Spring Boot 单体项目中用户、订单、商品等业务逻辑高度耦合的情况。推荐操作路径：先通过领域关键词识别模块边界 → 再生成微服务骨架与 API 契约 → 提取原有业务逻辑并替换为跨服务调用 → 最后配置网关路由与灰度发布规则。