合并冲突不再头疼:EnsoAI 内置三栏合并工具完整教程,一键采纳变更实时预览

原创2026-10-16 07:17:21397 阅读

合并冲突不再头疼:EnsoAI 内置三栏合并工具完整教程,一键采纳变更实时预览

Git 合并冲突是许多开发者的心头病:命令行里的 <<<<<<< 标记让人眼花缭乱,手动编辑稍有不慎就会改错。EnsoAI 内置的三栏合并工具正是为了解决这个痛点——它将冲突文件的"对方更改、当前更改、最终结果"并排展示,支持一键采纳变更与实时结果预览,让你彻底告别手动删标记的痛苦。本文带你从零走通一次完整的合并流程。

认识 EnsoAI:Worktree 管理与合并的一体化工具

EnsoAI 是一款 Git Worktree 管理器 + AI 编程助手结合的桌面应用,核心理念是"多个分支、并行流动"。你可以为每个功能分支创建独立的 Worktree 工作空间,互不干扰地开发,完成后再一键合并回主分支。

EnsoAI 主界面与 Worktree 列表

它的内置 Git 管理器覆盖了合并前的所有准备工作:变更列表、差异对比、提交代码都可以可视化完成,不用再反复切换到命令行。

EnsoAI 源代码管理面板与差异对比视图

启动合并:只需 3 步

第 1 步:在 Worktree 列表中发起合并

打开 Worktree 侧边栏,找到你要合并的工作空间,点击卡片上的 "Merge to Branch..."(合并到分支...) 按钮即可。该入口由 WorktreePanel.tsx 提供,合并相关的状态则由 useMergeState.ts 统一管理。

EnsoAI Worktree 工作空间列表与操作菜单

第 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 个区域:

EnsoAI 三栏合并工具解决冲突界面

  1. 顶部标题栏:显示"解决冲突"及进度(如 1/1),右侧有提交信息输入框、中止合并和完成合并按钮
  2. 文件导航条:多个冲突文件时,可左右切换;已解决的文件会打上绿色对勾
  3. 冲突块导航条:显示"冲突 x/x",支持上下切换冲突块,并提供 接受全部对方更改 / 接受全部我方更改 两个快捷按钮
  4. 三栏编辑器:
    • THEIRS(左):来源分支的更改,只读
    • RESULT(中):最终合并结果,可直接编辑,宽度更大
    • OURS(右):当前目标分支的内容,只读
  5. 底部状态栏:当前文件路径 + 已解决进度(如 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 并行开发模式——多个分支各自独立开发、互不打扰,最后集中合并——你的多分支工作流会顺畅得多。

登录后查看全文
EnsoAI