compare side-by-side 是 sublime text 最可靠的双栏对比插件，基于行内容相似度逻辑对齐，支持未保存文件、同步滚动、容忍缩进与空行差异，且不依赖 git 或外部命令。
Compare Side-By-Side 是目前 Sublime Text 上最可靠、开箱即用的双栏对比方案，不用调外部命令、不强制保存、不依赖 Git，只要两个文件已打开为独立标签页，右键就能启动。
为什么 Compare Side-By-Side 是首选？
它不是模拟双栏，而是基于行内容相似度做逻辑对齐：跳过空行、容忍缩进差异、支持同步滚动（非硬行号绑定），且对未保存 buffer 完全友好。而 Diffy 要求文件已保存、路径绝对；Sublime-Text-Compare 默认不启用忽略空白，配置项藏得深；Diff 插件只支持同一文件内选区比对——这些都不是真双栏。
-
Compare Side-By-Side只认“两个不同路径的已打开标签页”，不接受分屏副本或Untitled-1 - 高亮语义清晰：新增行浅绿底、删除行浅红底、修改行浅黄底
- 滚动任一侧，另一侧自动匹配逻辑行（比如删了三行后，后续内容仍能对齐）
- 不读取 Git 状态，也不提供复制/合并按钮——这不是缺陷，是设计边界
Compare Side-By-Side 安装失败的三个硬坑
名字输错、Package Control 失效、文件没“真正打开”，这三件事占了 90% 的“右键没菜单”问题。
- 插件名必须严丝合缝：
Compare Side-By-Side（带空格 + 连字符 + 末尾大写 S），搜CompareSideBySide或Compare Side by Side会装到废弃分支 - 先确认
Package Control: Install Package能正常执行；若报错，需重装 Package Control（控制台粘贴官网安装代码） - 装完不用重启，但右键菜单只出现在「已打开的文件标签页」上——侧边栏、编辑区空白处、
Untitled-1标签页均无效
对比结果全是红块？别急着换插件，先看状态栏右下角
Compare Side-By-Side 比的是 Sublime 当前加载进内存的原始字节流，不做任何后台转换。所谓“明明一样却标红”，几乎全是编码或格式陷阱。
- 一边是
UTF-8 with BOM，另一边是纯UTF-8→ 第一行必全红：右下角点编码名 →Reopen with Encoding→UTF-8，再保存 - 缩进混用
Tab和空格 → 每行都被当差异：按Ctrl+Shift+P→ 输入Convert Indentation to Spaces - 换行符不统一（
\r\nvs\n）→ 空行错位、注释偏移：右下角点Line Endings→ 统一选Convert to Unix (LF) - 开了
Word Wrap→ 物理行高不一致，同步滚动失效：View → Word Wrap必须关掉
大文件卡顿或同步失效？切换语法模式 + 关闭干扰项
超过 5000 行或含长 base64 块时，Sublime 会静默限流，插件停止监听滚动事件；同时，scroll_sync 设置对跨文件完全无效，别白配。
- 先切到
Plain Text语法模式：Ctrl+Shift+P→Set Syntax: Plain Text（禁用语法高亮可大幅提速） - 确保两个窗格都在同一窗口、同一 group（不能是两个独立窗口）
- 禁用所有可能劫持快捷键的插件，特别是其他 diff 类工具（如
Diffy或SublimeJ） - 关闭任一窗格后布局不会自动还原，需右键窗格 →
Reset View手动恢复
