compare side-by-side 插件必须严格输入全名“compare side-by-side”（带连字符、不可省略side），安装前需确认package control正常；对比文件须已保存并打开为独立标签页，右键位置限于文件标签顶部，且需统一编码、换行符与缩进格式。
装 Compare Side-by-Side 插件必须输对名字
别搜“compare”就点安装，Compare Side-by-Side 是唯一有效名称——带连字符、大小写不敏感，但不能漏 Side，也不能写成 CompareSideBySide 或 Compare Side By Side。输错一个字符，Package Control 就会装到废弃分支，右键菜单永远不出现。
安装前先确认 Package Control 活着：按 Ctrl+Shift+P（Win/Linux）或 Cmd+Shift+P（macOS），输入 Package Control: Install Package 回车。如果报 command not found，说明它没生效，得重装。
- 打开控制台（
Ctrl+`），粘贴 packagecontrol.io 官方安装脚本，回车执行 - 重启 Sublime Text，再试一次命令面板
- 等列表完全加载完（状态栏提示消失），再输入
Compare Side-by-Side
对比前两个文件必须“真打开”
Compare Side-by-Side 不读磁盘、不拉未保存 buffer，只认已加载进编辑器的独立标签页。状态栏显示 Untitled-1 或空路径？哪怕你刚按过 Ctrl+S，也得再点一次保存按钮，让路径落地。
- 两个标签页必须是不同路径的文件，不能是同一文件拖拽分屏产生的副本
- 右键位置必须精准：要右键文件标签页顶部（带文件名的小条），不是编辑区空白处，也不是侧边栏
- 快捷键
Ctrl+Alt+C（Win/Linux）或Cmd+Alt+C（macOS）失效时，试试命令面板搜Compare: Compare Files手动执行
整行标红？先统一编码和换行符
这个插件不做任何自动转换，UTF-8 with BOM vs UTF-8、\r\n vs \n、Tab vs 空格，都会导致整行误判为差异。第一行全红？八成是 BOM 问题。
- 右下角点击编码名 →
Reopen with Encoding→ 选UTF-8（去掉 BOM）→ 保存 - 右下角点击换行符标识 →
Convert Line Endings→ 选Unix (LF) - 缩进混用时，按
Ctrl+Shift+P→ 输入Convert Indentation to Spaces - 开启
draw_white_space设置，可肉眼识别行尾空格干扰
并排视图卡顿？关语法高亮+切纯文本
大文件（>5000 行或含长 base64 块）卡顿，不是插件慢，是 Sublime 在实时解析语法。它默认启用当前语法高亮，而 YAML/JSON/.env 文件的解析开销远高于纯文本。
- 按
Ctrl+Shift+P→ 输入Set Syntax: Plain Text，切到无高亮模式 - 确保
View → Word Wrap是关闭状态，否则物理行号错位，同步滚动失效 - 对比完成后再切回原语法，不影响编辑
它只做两文件静态文本比对，不读 Git、不合并、不跳转变更位置——想查这行是不是从 HEAD 改的，得另开终端跑 git diff。
