先说结论：如果你想在 Sublime Text 里比较两个文件差异，Compare Side-By-Side 依然是最轻量、最稳定、也最省事的方案之一。它没有额外依赖，不容易卡顿，界面响应快，中文编码也更少出问题，安装完成后基本可以直接使用——不过前提是插件安装路径要正确，使用方式也不能想当然。
本质上，这个插件就是用来解决“两个文件到底有哪些不同”这个高频需求的。很多人在 Sublime Text 中折腾半天却发现无法使用，问题通常并不出在插件本身，而是前面的安装或操作步骤没有对上。下面这些常见坑，提前避开就能省下不少时间。
安装插件前，先确认 Package Control 已正常可用
如果你按下 Ctrl+Shift+P（Win/Linux）或 Cmd+Shift+P（macOS）没有反应，或者输入 Install Package 之后毫无结果，那大概率说明 Package Control 还没有安装成功。这个步骤千万别省略，否则后续安装任何 Sublime Text 插件都可能悄悄失败，甚至连明显报错都没有。
- 从未安装过：按
Ctrl+`打开控制台，粘贴官网最新安装脚本（2026 年依然可用），执行后重启 Sublime Text - 已经装过但疑似异常：在命令面板搜索
Package Control: Upgrade Package，先把 Package Control 升级到最新状态 - 安装后仍然不可用：打开 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 并不是那种点击一次就自动弹出选择框的工具，它对使用前提有明确要求，缺少任何一项都无法正常比较文件：
- 两个文件必须已经在 Sublime Text 中分别打开，并以独立标签页存在（未保存的 Untitled 文件通常不行，除非你至少手动保存过一次）
- 不能只打开一个文件就希望插件再去“选择另一个路径”——它只识别当前已经打开的标签页，不支持临时从磁盘读取另一个文件进行对比
- 右键位置一定要正确：必须右键点击文件标签页本身（顶部显示文件名的位置），而不是编辑区域空白处，也不是左侧边栏
- 如果快捷键没有反应，检查是否被其他插件占用：在命令面板里搜索
Compare，确认是否存在Compare: Compare Files命令可供手动执行
对比结果一片红？多半是编码或换行符不一致
如果在并排比较视图中看到整列高亮、空行被大量标记为“删除”、注释位置明显错位，这通常不是 Compare Side-By-Side 插件本身的问题，而是两个文件的底层格式没有统一：
- 通过
File → Reopen with Encoding分别确认两个文件都使用UTF-8编码（尽量不要混用UTF-8 with BOM） - 检查换行符格式：看右下角显示的是
LF还是CRLF；如果不一致，可通过File → Line Endings → Convert to LF统一处理 - 超大文件（超过 5000 行）或超长单行内容（例如压缩后的 JSON）容易让界面卡顿甚至短暂冻结，这时建议先用
Ctrl+J处理空行，删除无意义空白后再进行文件对比
其实，真正让大多数用户卡住的，并不是“Sublime Text 怎么安装 Compare Side-By-Side”，而是“装好以后以为可以随便比较，结果发现它只识别已打开的标签页，而且编码和换行格式还必须一致”。与其反复重装插件，不如优先检查右键位置、文件打开状态以及编码设置，这往往更有效。
