通义灵码需完整上下文才能准确重构旧代码：确保项目被识别（.git存在或强制刷新）、状态栏显示“Ready”，再通过快捷键、右键菜单或对话框触发重构，最后人工校验类名、注入方式及测试通过。

你想用通义灵码把多年没动的旧代码理清楚，不是重写，而是让它可读、可测、可维护——比如把散落在5个Service里的用户校验逻辑抽出来，把嵌套4层的if-else改成策略分发，或者给没有注释的工具类补上Javadoc。这需要它真正理解你项目的历史结构，而不是只看当前文件。

确认旧项目已“被灵码认出”

打开IDEA或VS Code，确保项目根目录下存在【.git】文件夹；若项目是纯文件夹（无Git），右键项目名→“Reload project”强制刷新索引。

检查右下角状态栏是否显示“TONGYI Lingma: Ready”。若显示“Limited context”或空白，说明上下文加载失败——关闭所有非必要标签页后重启IDE，否则后续重构建议会漏掉跨文件调用关系。

这一步不可跳过。旧项目往往依赖路径混乱、模块未声明、配置分散，【没有完整上下文，灵码只会按单文件语义瞎猜】。

三种触发重构的方式，选对才有效

方法一：快捷键精准打点（适合局部逻辑）

用鼠标拖选一段重复出现的校验/转换/组装逻辑（至少3处相同结构）→ 按Ctrl+K（Windows）或Cmd+K（Mac）→ 输入“提取为公共方法并注入Spring Bean”→ 回车执行。

方法二：右键菜单直达（适合函数级优化）

将光标停在待重构的方法名上→右键→通义灵码→“重构代码”→选择“重命名变量”或“简化条件表达式”。注意：若菜单中只有“解释代码”没有“重构代码”，说明该方法未被识别为可重构单元——手动在方法上方加一行注释：// @refactor candidate: high cyclomatic complexity再试。

方法三：对话框讲清来龙去脉（适合跨文件改造）

点击右侧通义灵码图标→输入：“OrderController.java、PaymentService.java、RefundService.java 三个类里都有几乎一样的库存扣减逻辑，包含Redis锁、DB更新、MQ发送三步，但参数名和异常处理不一致。请生成一个InventoryDeductionService统一接管，并在原三处调用替换为@Autowired注入调用。”→ 发送。

验证与落地的关键动作

第一步：对比生成代码中的类名、包路径、注入方式是否与你项目现有规范一致；例如AI生成@RequiredArgsConstructor而你项目仍在用@Autowired构造器，必须手动改回。

第二步：运行原有单元测试，确认行为零变更；若测试失败，先检查AI是否误删了原始方法里的try-catch或日志打印——【AI 不继承原始注释语义】，关键日志和兜底逻辑需人工补回。

第三步：保存文件，重构完成。