16 · Git 工作流

Trae + Git：AI 帮你管理版本、写 commit message、处理冲突——但 push 的钥匙永远在你手里。

01 Trae 和 Git 的关系

Trae 的所有模式（Chat / Builder / SOLO）都对 Git 有天然感知。AI 知道当前分支、能看到 git status、能读取 diff——它在修改文件之前就知道”这是一个 Git 仓库”。

但关键原则始终不变：

本地操作（status、diff、add、commit）可以放手让 AI 帮忙，但 git push（推到远程）这一步，你的手必须在方向盘上。

02 AI 能帮你做什么

自动感知 Git 状态

AI 修改文件之前，通常会先检查：

• 当前在哪个分支
• 有哪些未提交的改动
• 工作区是否干净

如果工作区很脏（很多未提交改动），AI 会提醒你先整理。

写 Commit Message

这是 AI 最实用的 Git 辅助功能之一。在 Chat 或 SOLO 模式中：

你：帮我看看当前改了什么，写一个 commit message

AI 会：

1. 运行 git diff --staged 或 git status
2. 分析改动的性质和范围
3. 生成符合 Conventional Commits 规范的 message

示例输出：

feat: 新增用户邮箱验证功能

- 添加验证邮件发送服务
- 实现邮箱验证 token 生成和校验
- 新增验证状态中间件
- 补充单元测试（覆盖率 92%）

处理合并冲突

当你在 Builder 或 SOLO 模式下遇到合并冲突：

你：帮我解决 src/app.ts 的合并冲突，保留当前分支的改动

AI 会分析冲突内容，按你的意图解决，展示修改后的文件。

⚠️ 警告：合并冲突的自动解决建议逐文件 review。AI 可能误解你的意图，特别是涉及业务逻辑的冲突。

03 Trae 各模式下的 Git 行为

SOLO 模式下，AI 会在每个子任务完成后建议提交：

SOLO: ✅ 完成"添加登录表单组件"
     改动文件：src/components/LoginForm.tsx, src/styles/login.css
     建议提交：feat: 添加登录表单组件（含样式）
     
     [查看 diff] [批准提交] [跳过]

04 最佳实践

1. 小步提交

一次 SOLO 任务拆成 3-5 个小步骤，每步一个 commit。不要等整个功能全部完成才提交——出问题回滚成本太高。

✅ 好：commit 1: 类型定义 → commit 2: 核心逻辑 → commit 3: 错误处理 → commit 4: 测试
❌ 差：commit 1: 整个登录功能（15 个文件改动）

2. AI 改了什么，你审什么

在 git add 之前，用 git diff 逐文件看过 AI 的改动。不要在终端里 git add -A 然后直接 commit——你可能把 AI 的意外改动也提交进去了。

3. Push 永远是手动

# AI 可以帮你做这些（在 Approval 机制下）：
git add src/new-feature.ts
git commit -m "feat: add new feature"
 
# 这个必须你自己敲：
git push origin main

为什么：Push 意味着”我的代码进入共享仓库，可能触发 CI/CD、可能影响其他人”。这个决策只有人来承担。

4. 善用 git reflog

如果 SOLO 做了你不满意的改动，不要手动回退——用 git reflog 找回 commit hash，然后 git reset --hard <hash>。这比手动删代码安全得多。

05 常见陷阱

06 小结

下一篇：17 终端使用 —— Trae 内置终端的使用技巧和 AI 辅助命令执行。