合并冲突不再头疼:EnsoAI 内置三栏合并工具完整教程,一键采纳变更实时预览
合并冲突不再头疼:EnsoAI 内置三栏合并工具完整教程,一键采纳变更实时预览
Git 合并冲突是许多开发者的心头病:命令行里的 <<<<<<< 标记让人眼花缭乱,手动编辑稍有不慎就会改错。EnsoAI 内置的三栏合并工具正是为了解决这个痛点——它将冲突文件的"对方更改、当前更改、最终结果"并排展示,支持一键采纳变更与实时结果预览,让你彻底告别手动删标记的痛苦。本文带你从零走通一次完整的合并流程。
认识 EnsoAI:Worktree 管理与合并的一体化工具
EnsoAI 是一款 Git Worktree 管理器 + AI 编程助手结合的桌面应用,核心理念是"多个分支、并行流动"。你可以为每个功能分支创建独立的 Worktree 工作空间,互不干扰地开发,完成后再一键合并回主分支。
它的内置 Git 管理器覆盖了合并前的所有准备工作:变更列表、差异对比、提交代码都可以可视化完成,不用再反复切换到命令行。
启动合并:只需 3 步
第 1 步:在 Worktree 列表中发起合并
打开 Worktree 侧边栏,找到你要合并的工作空间,点击卡片上的 "Merge to Branch..."(合并到分支...) 按钮即可。该入口由 WorktreePanel.tsx 提供,合并相关的状态则由 useMergeState.ts 统一管理。
第 2 步:配置合并选项
弹出的合并对话框(MergeWorktreeDialog.tsx)提供了 4 个关键选项:
| 选项 | 说明 | 建议 |
|---|---|---|
| 目标分支 | 要合并进去的分支 | 默认选中 main/master/develop |
| 合并策略 | merge(创建合并提交)、squash(压缩为一个提交)、rebase(变基) |
日常用 merge,追求干净历史用 squash |
| 自动暂存 | 自动 stash 未提交的更改,合并后恢复 | 保持勾选 |
| 合并后清理 | 可选择删除 worktree 和分支 | 功能完成后一并勾选 |
第 3 步:等待合并结果
点击 Merge 后,后端 WorktreeService.ts 会依次处理暂存、执行 git merge 并检测冲突:
- ✅ 无冲突:直接完成合并(
--no-ff合并提交),并按你的选择自动清理 - ⚠️ 有冲突:自动打开三栏合并编辑器,进入下一步
三栏合并界面布局详解
冲突文件会自动加载到三栏合并编辑器(MergeEditor.tsx),界面从上到下分为 5 个区域:
- 顶部标题栏:显示"解决冲突"及进度(如
1/1),右侧有提交信息输入框、中止合并和完成合并按钮 - 文件导航条:多个冲突文件时,可左右切换;已解决的文件会打上绿色对勾
- 冲突块导航条:显示"冲突 x/x",支持上下切换冲突块,并提供 接受全部对方更改 / 接受全部我方更改 两个快捷按钮
- 三栏编辑器:
- THEIRS(左):来源分支的更改,只读
- RESULT(中):最终合并结果,可直接编辑,宽度更大
- OURS(右):当前目标分支的内容,只读
- 底部状态栏:当前文件路径 + 已解决进度(如
0/1 已解决)
几个贴心的细节:三栏编辑器滚动完全同步,任意一栏滚动,其余两栏自动跟随;左侧 THEIRS 和右侧 OURS 中,相对共同祖先有改动的行会用绿色/橙色高亮标出,当前处理的冲突块用蓝色边线突出,一眼就能定位差异。
一键采纳变更与实时结果预览
这是整个工具最爽的部分:
- 悬停即预览:鼠标移到左侧"接受 →"或"← 接受"按钮上时,RESULT 中间栏会实时预览采纳后的效果,移开鼠标自动还原。先预览、再决定,零风险
- 一键采纳:点击按钮后,当前冲突块立即写入 RESULT 栏,并自动跳到下一个冲突块
- 手动微调:RESULT 栏完全可编辑,采纳后想再改两行代码也完全没问题
- 整文件采纳:如果某一方整体更优,直接用"接受全部对方更改 / 接受全部我方更改"一键搞定
处理完当前文件的所有冲突块后,点击 RESULT 栏上方的 标记为已解决,文件会被写入磁盘并自动切换到下一个冲突文件。
完成合并提交
所有冲突文件解决后(底部进度变为 1/1 已解决),在顶部提交信息框中确认信息(默认是 Merge branch '分支名'),点击 完成合并 即可生成合并提交。
如果中途发现方向错了,随时点击 中止合并(git merge --abort),工作区会恢复到合并前的状态,不用担心回不去。
常见问题速查
Q:合并时主分支有未提交的修改怎么办? 勾选"自动暂存"选项,EnsoAI 会在合并前自动 stash,合并成功后自动恢复,全程无需手动操作。
Q:rebase 策略遇到冲突会怎样?
同样会弹出冲突处理界面,解决后 EnsoAI 会执行 git rebase --continue 继续变基流程。
Q:想撤销整个合并可以吗? 可以。点"中止合并"即可一键回退;合并完成前它不会写入任何不可逆的提交。
Q:这个工具替代命令行吗?
对于常规合并场景完全可以;它基于 simple-git 封装(见 WorktreeService.ts),底层就是标准 Git 操作,不会破坏任何工作流。
小结
| 场景 | 推荐操作 |
|---|---|
| 常规功能合并 | merge 策略 + 自动暂存 |
| 追求干净的提交历史 | squash 策略 |
| 冲突文件多 | 善用文件导航条左右切换 |
| 整侧代码更优 | "接受全部对方/我方更改" |
| 拿不准怎么改 | 悬停按钮先看实时预览 |
掌握这套流程后,合并冲突从"令人头疼"变成"点点鼠标"。配合 EnsoAI 的 Worktree 并行开发模式——多个分支各自独立开发、互不打扰,最后集中合并——你的多分支工作流会顺畅得多。



