Sublime怎么比较两个文件差异？CompareSideBySide插件安装

先直接说结论：在 Sublime Text 里做文件并排对比，Compare Side-By-Side 绝对是最轻量、最稳定、也最省心的选择。没有依赖、不卡界面、不乱码，装完就能用——但前提是安装路径别搞错，触发方式也别想当然。

说白了，这插件就是拿来解决“两个文件到底哪里不一样”这个老问题的。但不少人折腾半天发现用不了，原因往往不在插件本身，而是前面几步没对齐。下面几个坑，绕过去就行。

装插件前先确认 Package Control 已就位

如果 Ctrl+Shift+P（Win/Linux）或 Cmd+Shift+P（macOS）按下去没反应，或者输入 Install Package 后毫无动静，那八成是 Package Control 根本就没装。别跳过这一步，否则后面所有插件安装都会安静地失败，你连报错都看不到。

• 没装过：按 Ctrl+` 打开控制台，粘贴官网最新安装脚本（2026 年仍然有效），回车后重启 Sublime
• 已装但失效：在命令面板里搜 Package Control: Upgrade Package，先把自己的底座升级一遍
• 装完还是不生效？检查 Sublime 控制台（Ctrl+`）有没有报 failed to load package 这类错误

安装 Compare Side-By-Side 的唯一可靠路径

注意，插件名必须完全精确：Compare Side-By-Side——中间是空格加连字符，不是下划线，末尾没有多余的 s。如果搜 CompareSideBySide 或 Compare Side By Side，大概率会装上旧版或者已经废弃的分支，白白浪费时间。

• 按 Ctrl+Shift+P → 输入 Package Control: Install Package → 回车
• 等列表加载完成（几秒钟，别急着输第二个字）→ 输入 Compare Side-By-Side
• 选中后回车，状态栏显示 Successfully installed Compare Side-By-Side 才算成功
• 无需重启，立刻能用；如果右键菜单没出现选项，试试 Ctrl+Alt+C（Win/Linux）或 Cmd+Alt+C（macOS）快捷键

装完打不开？先排除这三个硬性条件

Compare Side-By-Side 不是那种点一下就弹窗的傻瓜工具，它对前置状态有明确要求，少一个都白搭：

• 两个文件必须已经打开为独立标签页（未保存的 Untitled 文件不行，除非你手动保存过一次）
• 不能只打开一个文件然后指望它“选另一个路径”——它只认当前已打开的标签页，不支持从磁盘临时读取
• 右键位置必须精准：要右键文件标签页本身（顶部那个带文件名的小条），而不是编辑区空白处或侧边栏
• 如果快捷键无效，检查是否被其他插件劫持：在命令面板搜 Compare，看有没有 Compare: Compare Files 命令可以手动执行

对比时发现全是红块？大概率是编码或换行符打架

并排视图里整列高亮、空行全标为“删除”、注释位置错位——这种场面跟插件好坏没关系，问题出在两个文件底层格式不一致上：

• 用 File → Reopen with Encoding 分别确认两边都是 UTF-8（而不是 UTF-8 with BOM）
• 检查换行符：右下角看是 LF 还是 CRLF；不一致时，用 File → Line Endings → Convert to LF 统一
• 大文件（超过 5000 行）或超长行（比如压缩过的 JSON）会导致 UI 卡顿甚至冻结，这种情况先用 Ctrl+J 合并空行、删掉无意义的空白再对比

实际上，真正卡住大多数人的地方，不是“怎么装”，而是“装完以为随便比就行，结果发现它只认已打开的标签页 + 编码必须严丝合缝”。多试两次右键位置和编码设置，比重装十遍插件管用多了。