IntelliJ IDEA 的 Git 冲突三栏界面需满足 UnmergedPath 状态且成功调用 getMergeBase() 才激活，常见失效原因包括 autocrlf 导致行尾误判、本地未提交+stash 混用、文件被标记为 binary 或项目未正确识别为 Git 仓库；左侧/右侧窗格只读，中间编辑区修改后必须保持 AST 语法树一致（如同步更新 import），否则提交失败；“解决所有简单冲突”仅处理行级无重叠变更，嵌套结构、跨行字符串、注解位置等语义冲突仍需手动在三栏视图中右键选择 Use Left/Right Side。
IntelliJ IDEA 的 Git 冲突图形化界面不是“打开就能用”的简单对比工具，它依赖三路合并（base–ours–theirs）语义解析，且默认行为受 Git 配置和 IDEA 设置双重影响——直接点“Accept Left”可能丢掉重构后的导入或重命名，不看中间窗格的 AST 高亮就手动编辑容易引入语法错误。
冲突弹窗出现后，为什么有时看不到三栏视图？
IDEA 只在检测到 UnmergedPath 且能成功调用 GitMergeUtil.getMergeBase() 时才激活完整三栏界面。常见失败原因：
-
git config --global core.autocrlf true导致行尾差异被误判为内容冲突，实际无逻辑变更 - 本地未提交的修改 + stash 混用，使
ours版本无法准确定位 - 文件被标记为 binary（如
.idea/workspace.xml），IDEA 自动降级为纯文本 diff - 项目未正确识别为 Git 仓库（
.git目录权限异常或被 IDE 忽略）
左侧/右侧窗格显示“只读”，但中间编辑区改完却无法提交？
中间窗格内容必须与当前分支的 base 提交保持语法树一致，否则 commit 会失败并提示 “Invalid PSI structure”。典型陷阱：
- 直接复制粘贴右侧代码到中间区，但没同步更新左侧已删的 import 语句 → 编译报错
- 接受右侧变更后，IDEA 自动触发
Optimize Imports，但该操作未纳入冲突解决流程 → 中间区显示正常，提交后 CI 编译失败 - 在 Kotlin 文件中合并 lambda 表达式时，IDEA 的 AST 解析器对
it参数绑定不敏感，手动删改易破坏作用域
点击“解决所有简单冲突”后，部分文件仍标红？
所谓“简单冲突”仅指行级无重叠修改（例如：同一函数内，左侧增一行注释，右侧改一行 return 值）。以下情况不会被自动处理：
Pilot Digital Twin Setup
下载
部署一个包含 4 个智能体（agent）的数字孪生平台。在以下情况下使用该技能： 1. 用户希望为物理资产监控与预测性维护等场景搭建数字孪生系统……
- 嵌套结构冲突：如
if块内左侧删了else分支，右侧改了if条件表达式 - 跨行字符串拼接：左侧写
"user" + "name"，右侧写"username"，AST 判定为语义冲突 - 注解位置变动：Lombok 的
@Data被移到类声明上方，而另一方删了该注解 → 视为符号冲突
此时必须双击文件进入三栏视图，右键冲突块选择 Use Left Side 或 Use Right Side，而非依赖中间区手动敲字。
为什么右键“Accept Left Side”后，代码里还留着
这是 IDEA 未完成冲突清理的明确信号——它只修改了内存中的 PSI 结构，但没同步更新文件磁盘内容。根本原因是：
- 文件处于“未加入索引”状态（
git status显示为unmerged），IDEA 的提交动作被阻断 - 你提前关闭了冲突对话框，导致
GitToolBox插件未触发markResolved()回调 - 项目启用了
Enable Git gutter icons但禁用了Highlight merge conflicts，视觉反馈失效
必须回到 Git Tool Window → Local Changes → Merged Files 节点，右键对应文件选 Resolve Conflict，再执行一次确认操作，标记才会真正清除。
