百度Comate在代码重构方面确实表现出色——它能在理解代码语义的基础上，帮助你一键拆分复杂大函数、智能重命名变量、按照架构规则重组目录结构，甚至还能保留你指定的关键注释。简单来说，它是一种“先读懂你的代码再动手”的重构方式，绝非机械的文本替换。

坦白说，代码重构是许多开发团队长期面临的难题。面对那些年久失修的旧代码，读起来像一团乱麻，想修改又担心牵一发而动全身。但有了Comate之后，情况可能会有所改观。它并非简单帮你替换几个变量名，而是真正理解上下文之后，从语义层面重新组织代码。那么具体该怎么操作呢？

用Comate一键拆分大函数

打开一个臃肿的源文件，在函数体里随便找一个位置，输入 // 按职责将此函数拆分为多个小函数，然后按下 Ctrl+Shift+C（VS Code默认快捷键），Comate就会开始工作。

它会自动分析该函数内部的参数流向、数据依赖关系和副作用，然后生成一组职责明确的独立函数。举个例子，如果原始函数同时承担了“读取→校验→转换→写入”这四项工作，Comate不会将它们全部塞进一个函数，而是分别生成 parseInput、validateData、transformPayload、persistResult 这四个小函数，并在原函数中用清晰的调用链条替代冗长的逻辑体。

生成新函数的同时，Comate还会同步更新所有调用处，包括跨文件引用。不过这里有一个前提：你的项目必须正确配置了技术栈，比如拥有完整的 tsconfig.json 或 babel.config.js 这类配置文件。如果配置缺失，Comate就只能执行局部重构，无法感知外部依赖，效果会大打折扣。

批量重命名变量与方法

相比手动逐个修改，Comate的语义化重命名要省心得多。选中你要修改的变量或方法名，右键 → Refactor with Comate → Apply semantic rename，即可完成。

Comate会分析这个标识符在整个项目中的使用场景：如果它是API响应字段，就按后端返回的JSON key风格处理（比如snake_case）；如果是React组件的状态，就转换为camelCase并加上use前缀；如果是配置常量，则统一转成UPPER_SNAKE_CASE。

这里最巧妙的地方在于，你无需手动编写任何命名规则。Comate会从你已有的代码模式中学习命名惯性。比如如果你的项目中之前一直使用 userProfileData、orderStatusMap 这类camelCase加名词组合，它就不会突然把新变量改成 user_profile，而是延续你习惯的风格。

按架构意图重构目录结构

想要整体调整项目的目录结构？Comate同样可以胜任，但需要先创建一个规则文件。

第一步：在项目根目录下新建 comate_rules.yaml，写入类似于以下的内容：

rules:
- name: "layered-structure"
description: "强制按domain→application→infrastructure分层"
target: "src/**/*"
action: "move-to-layer"

第二步：打开任意一个混乱的业务文件，输入 // 按领域驱动分层重构整个src目录，再按Ctrl+Shift+C。

Comate读取规则后，会将 src/api/user.ts 移入 src/infrastructure/api/user.client.ts，将 src/utils/validation.ts 归入 src/application/validation.service.ts。最省心的是，所有import路径也会被自动修正。

不过要注意，规则文件必须放在项目根目录，且文件名不能有拼写错误。否则Comate会完全忽略该规则，什么都不会发生。

重构时保留关键逻辑注释

有些代码块虽然看起来奇怪，但就是不能动——这种情况在遗留系统里非常常见。Comate也考虑到了这一点。

方法一：在你想要保留的注释上方加上 // @keep 标记，Comate在重构时会原样保留，并将其放到对应新函数的顶部。

方法二：对整段逻辑块使用 /* @preserve */ 包裹。例如：

/* @preserve */
// 这段位运算必须保持顺序，不可拆分
const mask = (1 << bitPos) & 0xFF;
return data | mask;

Comate识别到@preserve指令后，就不会对该代码块做任何结构调整、内联或提取，哪怕它看起来完全可以提炼成复用逻辑。

这几个功能组合起来，其实已经覆盖了日常重构中90%以上的场景。从拆分大函数、统一命名到重组目录结构，再加上对敏感注释的保留，基本可以做到“一键重构，心中有数”。