split-diff需先手动分屏再按快捷键触发:右键tab选Split Right/Down,拖入第二文件,再按Ctrl+Alt+T(Win/Linux)或Cmd+Alt+T(macOS);依赖.git目录启用Git模式,且须统一左右窗格换行符(推荐LF)并保存后才刷新差异。

split-diff 怎么触发并确保生效
它不会自动弹出,必须手动分屏后再按快捷键,否则静默失败。装完 split-diff 后,得先打开两个文件,并让它们处于不同窗格:右键任一 tab → Split Right 或 Split Down,再把第二个文件拖进新窗格。之后按 Ctrl+Alt+T(Windows/Linux)或 Cmd+Alt+T(macOS)才能激活对比视图。
常见错误:只开一个 tab 就猛按快捷键,split-diff 不会帮你新开窗格,也不报错,直接没反应。
Git 模式为什么没亮?
split-diff 的 Git 上下文比对(比如工作区 vs 暂存区)依赖项目根目录存在 .git 目录。纯文件夹、未初始化 Git 仓库、或 .git 在子目录里,都会导致 Git 模式不可用——此时只能手动选两个文件比对。
检查方式很简单:在 Atom 项目根目录下运行 ls -a | grep .git(macOS/Linux)或 dir /a .git(Windows),有输出才算有效。
对比结果全是红块?换行符惹的祸
左右窗格换行符不一致(一边是 CRLF,一边是 LF),split-diff 会把整行标为差异,误报率极高。
统一方法:
- 关闭 Editor → Soft Wrap
- 进入 Editor → Line Endings,手动设为同一格式(推荐全用 LF)
- 对已打开文件,右下角状态栏点击换行符标识,可即时切换
左右窗格能编辑但改完不更新对比?
split-diff 是实时监听文件内容变化的,但仅限于“保存后”刷新。编辑时不更新,保存后才重算差异——这点和 IDE 内置 diff 不同,容易误以为卡住。
注意:
- 修改后必须 Ctrl+S(或 Cmd+S)保存,对比视图才会同步
- 如果改完没保存就切走,再回来时差异标记可能滞后一帧
- 它不支持未保存缓冲区(unsaved buffer)的跨窗格 diff,临时文件或无名 tab 无法参与比对
实际用起来最常卡住的地方,不是插件装不装得上,而是分屏动作漏了、.git 找不见、或者换行符没对齐——这三个点占了 90% 的“怎么没反应”类问题。

















