atom本身无原生文件对比功能，必须安装并正确启用split-diff插件；需通过apm命令行安装、在settings中确认启用、确保两个已保存文件分置左右窗格、换行符与编码统一，并满足git项目路径要求才能触发ctrl+alt+t有效对比。
Atom 本身不提供原生文件对比功能，所有可用的比对能力都依赖插件；目前唯一稳定、仍在维护、支持并排编辑和 Git 上下文的方案是 split-diff。其他插件如 diff-pane 已基本停更，在新版 Atom 上频繁报 Cannot compare with itself，git-diff 和 git-gutter 则只做行级标记，不能并排查看或编辑。
怎么装好 split-diff 并让它真正生效
装插件只是第一步，多数人卡在“装了但按 Ctrl+Alt+T 没反应”——问题不在快捷键，而在插件是否被正确激活和识别环境：
- 用
apm install split-diff命令行安装比 Settings → Install 更可靠，尤其当 Atom 版本较新时 - 装完必须去
Settings → Packages → split-diff确认开关为 Enabled，不是“Installed”就等于可用 - 如果命令面板（
Ctrl+Shift+P）搜不到split-diff:toggle，关掉 Atom 再重开一次；若仍不行，进View → Developer → Toggle Developer Tools看 Console 是否有Failed to activate package - 插件默认不开启实时监听，想改一行就立刻刷新差异，得手动运行
split-diff:enable命令（命令面板输入即可）
split-diff:toggle 按了没反应？先检查这四件事
这不是插件坏了，而是它对前置条件极其敏感。常见“静默失败”场景全集中在以下四点：
- 当前编辑器里只打开一个文件（哪怕你心里想着要对比两个）→ 它不会自动帮你新开窗格，必须先
Pane: Split Right或拖文件进新 pane - 两个文件路径实际指向同一磁盘位置（比如一个用
./src/index.js，另一个用/full/path/src/index.js）→ Atom 缓存识别为同一 buffer，直接跳过 - 至少一个文件还是
untitled（状态栏显示未保存）→ 必须先Cmd+S/Ctrl+S存成真实路径 - 左右窗格换行符不一致（左是
LF，右是CRLF）→ 大量误标红块；统一方式：右下角状态栏点击LF或CRLF，手动设成一样
Git 项目里怎么一键对比“当前修改”和“HEAD”
这是 split-diff 最实用的场景，但它不像 IDE 那样全自动——触发逻辑很具体：
- 项目根目录下必须有
.git文件夹，且 Atom 是从该目录启动，或已通过File → Add Project Folder加载 - 只打开一个文件（比如
index.js），然后执行split-diff:toggle→ 左窗格是你正在编辑的内容，右窗格自动加载该文件的HEAD版本 - 想对比暂存区（staged）？先
git add index.js，再触发命令；想对比上游分支（如origin/main）？得用命令面板输入split-diff:compare-with-remote（需插件 v1.5.0+） - 注意：
split-diff的 Git 模式只作用于当前活动文件，不会自动拉取整个 diff 列表或跨文件批量比对
对比结果全是红/绿块，但内容其实差不多？
这不是渲染 bug，而是差异算法在“上下文重组”时的正常行为。Myers 算法追求最小编辑距离，遇到结构变动大时会把几行删+几行增，合并解释为“移动”或“替换”，导致高亮块不直观：
- 先试
split-diff:set-ignore-whitespace（命令面板输入），排除缩进、空格、空行干扰 - 关掉
Auto Diff（Settings → Packages →split-diff→ 取消勾选），手动触发一次干净计算 - 别对比超长文件（>2000 行），性能下降明显，差异定位变慢；真要审大文件，不如终端跑
git diff -U0 HEAD -- path/to/file.js | head -n 50 - 右下角状态栏若显示
UTF-8 BOM和UTF-8并存，点击编码名统一成无 BOM 的UTF-8，否则 BOM 字节会被当成差异
真正容易被忽略的是：所有这些操作都建立在 Atom 能准确识别 Git 工作树的前提下。如果项目用了子模块、裸仓库、或 .git 在上层目录但 Atom 打开的是子目录，split-diff 就会退化为普通文件比对，Git 模式完全失效。
