split-diff 插件需先手动分屏并打开两个文件/文本块才能触发比对,未分屏时快捷键无效;它对换行符、软换行敏感,需统一为LF且关闭Soft Wrap;比对为静态快照,编辑后需重新触发,不支持选区直比或实时同步。

split-diff 插件必须先分屏再触发
直接按 Ctrl+Alt+T(Windows/Linux)或 Cmd+Alt+T(macOS)不会自动开新窗格,split-diff 会静默失败。它只对比已存在于不同窗格中的两个文件/文本块。
- 先右键任一 tab → Split Right 或 Split Down
- 把第二个文件拖进新窗格;若比对同一文件内两段内容,需先复制粘贴到新窗格并保存为临时文件
- 确认两个窗格都已打开且有内容,再按快捷键
- 没分屏就按快捷键:无报错、无反应——这是最常被卡住的点
纯文本比对要关掉 Soft Wrap 和统一换行符
split-diff 对换行符和软换行极其敏感,哪怕只是 LF vs CRLF,也会把整行标红,误判为差异。
- 进入 Settings → Editor,关掉
Soft Wrap - 右下角状态栏点击
LF或CRLF,统一设为LF(推荐)或双方一致 - 如果文本来自 Windows 环境剪贴板,粘贴前先用
Cmd+Shift+P→Editor: Convert Line Endings to LF - 忽略空白差异?可运行
split-diff:set-ignore-whitespace命令(默认不开启)
想比对非 Git 项目里的任意两段文本,只能手动准备
split-diff 的 Git 模式(如工作区 vs 暂存区)依赖项目根目录存在 .git。纯文件夹或临时文本片段,它不识别上下文,只能靠人工塞进两个窗格。
- 不能直接选中两段文字后一键比对——Atom 没有原生“选区 diff”功能
- 临时方案:复制第一段 → 新建文件粘贴 → 保存为
a.txt;同理第二段存为b.txt;再分屏打开这两个文件 - 别用未保存的临时标签页,
split-diff在某些版本里对 unsaved tabs 支持不稳定 - 比对完想保留结果?左侧窗格编辑后,右侧不会联动更新——它是静态快照,不是实时同步视图
左右窗格可编辑,但改完不会自动刷新差异
这是 split-diff 和传统 diff 工具的关键区别:你能在任一侧直接修改,但差异标记不会动态重算,得手动重新触发。
- 编辑任一窗格后,差异色块不会消失或变化——它只在 toggle 时计算一次快照
- 想看最新差异,必须再次按
Ctrl+Alt+T(或运行split-diff:toggle) - 编辑过程中若删了某行,另一侧对应位置可能悬空,导致后续行错位匹配——这不是 bug,是逐行对齐逻辑的自然结果
- 真正容易被忽略的是:关闭其中一个窗格后,
split-diff不会自动停用,残留的差异高亮可能误导后续操作

















