当函数膨胀、嵌套过深或重复代码散布各处时，手动调整既耗时又容易引入新 Bug。CodeBuddy 的重构优化能力可在保持业务逻辑不变的前提下，对代码结构进行自动化调整，并生成清晰的变更对比。
操作入口
- 选中代码后触发：在编辑器中框选目标代码块（或仅将光标置于函数内部），右键菜单选择 CodeBuddy > 重构优化，或点击行内出现的 CodeLens 快捷链接。
- 侧边栏工具集：在右侧"一键代码处理"面板中，先粘贴或引用代码，再点击"重构优化"按钮。
- 追加指令：生成结果不满意时，可在对话中继续补充要求，如"保持原有函数签名不变"或"将公共部分提取到 utils 文件"。
常见重构场景
| 场景 | 说明 |
|:---|:---|
| 函数拆分 | 将过长的函数按职责拆分为多个单一功能的子函数，自动处理参数传递与返回值。 |
| 简化嵌套 | 将深层 if-else 嵌套转换为卫语句（guard clauses）或提前返回，降低圈复杂度。 |
| 消除重复 | 识别多处相似代码逻辑，建议提取为独立函数或配置化数据，并替换原有调用点。 |
| 接口抽象 | 针对具体类直接耦合的场景，自动生成接口或抽象层，帮助解耦模块依赖。 |
| 依赖整理 | 移除未使用的导入/头文件，调整依赖顺序，或建议更轻量的替代库。 |
使用流程
- 划定范围：建议以单个函数、单个类或一个独立模块为粒度发起重构，避免一次性提交上千行导致变更难以审阅。
- 触发并指定约束：若团队有特定规范（如"禁止超过 3 层嵌套"或"必须保持原有日志埋点"），可在触发时通过注释或侧边栏输入框一并说明。
- 审阅 Diff：CodeBuddy 通常会以对比视图展示变更前后差异，重点关注：
- 边界条件是否被意外修改；
- 异常处理分支是否完整保留；
- 对外暴露的 API 签名是否发生变化。
- 应用或部分采纳：确认无误后点击"应用变更"；若局部不符合预期，可复制建议代码后手动合并，或仅采纳部分修改。
实用建议
- 先保存或提交：重构前确保当前文件已保存，最好在 Git 工作区无未提交改动，便于一键回退。
- 结合 @规则：如果团队已配置编码规范（见 3.4.4），在重构时通过
@规则引用，可让 AI 在调整结构的同时自动对齐命名约定、分层要求等。 - 验证行为一致性：结构改动后，务必运行现有单元测试或进行简单冒烟验证。AI 虽不会改变显性逻辑，但对异步流程、闭包引用或副作用的处理仍需要人工把关。