代码重构是在不改变原有业务功能的前提下，对已有可运行代码进行结构、可读性、性能、可维护性的优化，是清理技术债、翻新旧代码、统一团队编码规范的常用功能。相比手动逐行调整，AI 重构可快速完成标准化优化，大幅降低改造成本。
一、三种触发方式，按需选用
功能入口与其他代码处理能力保持一致，根据重构范围和复杂度选择对应方式即可。
1. 悬浮工具栏（小段代码快速优化）
适合单个函数、单段逻辑的轻量优化，操作最快：
- 用鼠标选中需要重构的代码片段；
- 代码右侧弹出悬浮工具栏，点击「重构」按钮；
- 侧边栏自动输出优化后的代码，核对功能无误后可一键替换回原文件。
2. 右键菜单（中等复杂度代码块）
适合多段逻辑、单个模块的标准化重构，操作最直观：
- 选中目标代码范围（可包含多个函数）；
- 点击鼠标右键，选择「Codex → Refactor code（重构代码）」；
- 等待几秒即可得到优化后的完整代码，默认兼顾可读性与结构规范。
3. 侧边栏对话（自定义重构目标）
需要指定优化方向、遵循特定规范、处理复杂业务代码时使用，支持个性化定制：
- 选中目标代码后打开 Codex 侧边栏；
- 输入明确的重构要求，比如“只优化性能，不改动代码结构”“按照团队规范统一命名和注释风格”；
- 生成后可反复调整要求，直到符合预期标准。
二、主流重构场景与指令模板（直接套用）
针对不同优化目标，使用对应指令可大幅提升结果精准度，避免过度设计或优化偏离需求。
- 可读性优化（最常用）
面向晦涩旧代码、复杂嵌套逻辑，目标是易读、好维护。
> 指令模板：优化这段代码的可读性，拆解深层嵌套逻辑，变量和函数命名语义化，核心逻辑补充中文注释，严格保留所有原有业务功能和边界处理不变。
- 结构模块化优化
面向大段耦合代码、重复逻辑，目标是拆分职责、提升复用性。
> 指令模板：将这段代码按单一职责拆分成多个独立小函数，抽离公共逻辑做成可复用工具，减少重复代码，保持输入输出规则完全不变。
- 性能优化
面向循环密集、计算量大的代码，目标是降低耗时、减少资源消耗。
> 指令模板：分析这段代码的性能瓶颈，优化循环逻辑、减少重复计算和不必要的资源申请，优化后功能完全一致，并标注所有核心优化点。
- 编码规范统一
面向团队协作场景，目标是对齐统一的语法与风格标准。
> 指令模板：按照 ES6+ 现代语法规范重构这段代码，统一使用箭头函数、解构赋值等写法，去除冗余写法，保持原有逻辑不变。
三、提升重构效果的实用技巧
- 目标越具体，效果越精准
不要只说“帮我重构一下”，明确说明核心诉求：是优化可读性、提升性能，还是统一规范，避免 AI 做不必要的过度设计。
- 小范围验证，再全量替换
先重构单个核心函数，验证功能正常后，再逐步扩大到整个模块。避免一次性改动整文件，出问题后难以定位原因。
- 要求附带改动说明
在指令末尾加上“最后列出所有改动点和优化原因”，方便核对逻辑，也能确认 AI 没有私自修改业务规则。
- 提前说明特殊边界逻辑
如果代码包含异常兼容、特殊业务规则、历史遗留兼容逻辑，提前在指令中备注，避免重构后被当作冗余代码删掉。
四、常见问题与处理
- 重构后业务逻辑变了
不要直接替换使用，补充指令重新生成：“重构改变了原有业务逻辑，请严格保留所有输入输出规则和边界处理，只优化写法和结构，不改动功能”，可附上测试用例辅助对齐。
- 重构后代码更复杂、过度设计
明确收敛诉求：“不需要过度抽象，保持简洁实用即可，不要引入额外依赖和不必要的封装，优先保证易读性”。
- 大段代码重构后逻辑混乱
不要一次性全选整文件，按功能模块拆分成 2~3 段分批重构：先梳理整体结构，再逐个优化内部函数，最后统一代码风格。
实用小提示：核心业务代码重构后，务必跑一遍原有测试用例，确认输入输出完全一致再投入使用，避免隐性逻辑改动引发线上问题。