split-diff插件需在atom的settings→install中搜索安装，装完须启用auto diff和ignore whitespace选项；对比前需将两个已保存文件分别置于左右窗格，再按ctrl+alt+t（win/linux）或cmd+alt+t（macos）触发并排高亮差异。
split-diff 插件怎么装和启用
Atom 本身不带原生 Diff 功能，必须装插件。目前最稳定、维护还在继续的是 split-diff，不是已停更的 diff-pane（后者在新版 Atom 上常报 Cannot compare with itself）。
实操建议：
- 打开 Atom → Settings → Install，搜
split-diff，点 Install - 装完别急着用，先去 Settings → Packages → split-diff → Settings，勾选
Auto Diff（自动对比）和Ignore Whitespace（忽略空格差异，避免误标） - 如果命令面板里搜不到
Split-Diff: Toggle，说明插件没激活：关掉 Atom，重开一次；或进 DevTools（View → Developer → Toggle Developer Tools）看 Console 有没有报Failed to activate package
两个文件怎么并排打开再对比
split-diff 不支持右键选两个文件直接比，它只对比「当前已打开且分在不同窗格里的两个文件」。
正确流程：
- 先用
File → Add Project Folder把两个文件所在目录都加进项目树（否则插件可能找不到路径） - 用
Cmd+T（macOS）或Ctrl+T（Windows/Linux）分别打开两个文件 - 把其中一个文件拖到右侧窗格（或用
Pane: Split Right命令），确保两个文件各占一栏 - 按快捷键
Ctrl+Alt+T（Windows/Linux）或Cmd+Alt+T（macOS），立刻高亮差异
注意：split-diff 默认会把换行符（CRLF vs LF）当差异处理。如果两边显示大片红色/绿色但内容其实一样，去 Settings → Editor 关掉 Soft Wrap（自动换行），并在右下角状态栏手动统一设成同一种换行符。
为什么对比没反应或全红全绿
常见错误现象包括：按了 Ctrl+Alt+T 没变化、整行变红但你确定只改了一个字符、左边右边内容一样却标出差异。
原因和解法：
- 两个文件还没保存 → 状态栏显示
untitled：必须先Cmd+S存成真实路径文件 - 用了符号链接或相对/绝对路径混用 → 实际指向同一物理文件：检查底部状态栏路径，确保左右显示的路径字符串完全不一致
- 文件编码不一致（比如一个 UTF-8 BOM，一个无 BOM）→ 在右下角状态栏点击编码名，统一设为
UTF-8 - 启用了
Show Word Diff但文件含大量 HTML/JSON → 字符级比对会把标签结构全标为差异，关掉这个选项即可
Git 场景下怎么比暂存区或历史版本
split-diff 只能比已打开的两个普通文件，没法直接接入 Git 工作流。想比 HEAD 和工作区、或两个 commit，得换路子。
推荐做法：
- 装
git-diff插件：它会在编辑器左侧 gutter 显示+/-标记，快捷键alt-g up/down跳转差异 - 终端里用
git difftool -t meld --no-symlinks HEAD~1 -- path/to/file.js（需提前装meld或Beyond Compare） - Atom 设置里配外部 diff 工具：在
Config...的core区块加"fileEncoding": "utf8"，避免编码错乱；再把git config --global diff.tool atom配上（需额外写 wrapper 脚本启动 Atom 并传参）
真正高频的 Git 对比，别硬撑用 Atom 插件——它既不能双向编辑差异块，也不支持暂存区预览，容易漏改或误提交。
