Sublime Text手动安装Compare Side-By-Side插件须将解压后的文件夹直接放入Packages目录（非Installed Packages），并手动配置快捷键；插件不自动处理编码、换行符或缩进，需统一为UTF-8与LF且剥离BOM，否则导致整行误标红。
手动安装 Compare Side-By-Side 插件必须放对目录
Sublime Text 手动安装插件，核心是把插件文件夹放进 Packages 目录，不是 Installed Packages。装错位置插件根本不会加载。
- 先通过菜单 Preferences → Browse Packages… 打开真实路径（Windows 是
%APPDATA%\Sublime Text 3\Packages\，macOS 是~/Library/Application Support/Sublime Text 3/Packages/） - 从 GitHub 下载
Compare Side-By-Side仓库 ZIP（注意：不是CompareSideBySide或其他变体），解压后得到一个文件夹 - 把这个文件夹直接复制进刚打开的
Packages目录，**不要嵌套在子文件夹里** - 重启 Sublime Text，右键任意已打开的标签页，应出现 Compare Side by Side 选项
手动安装后快捷键不生效？检查命令绑定是否缺失
手动安装的插件默认不带快捷键绑定，Ctrl+Alt+C（Win/Linux）或 Cmd+Alt+C（macOS）不会自动生效。
- 打开菜单 Preferences → Package Settings → Compare Side-By-Side → Key Bindings
- 在右侧用户配置窗口中添加以下内容（注意逗号结尾）：
[
{
"keys": ["ctrl+alt+c"],
"command": "compare_side_by_side",
"context": [
{ "key": "setting.is_widget", "operator": "equal", "operand": false }
]
}
]
"ctrl+alt+c" 改成 "super+alt+c"
对比时整行标红？手动安装不等于自动处理编码
手动安装的插件和通过 Package Control 安装的行为一致——它不做任何后台转换。编码、换行符、BOM 不统一，差异就会误报。
- 两个文件都右下角点击编码名 → 选 Reopen with Encoding → UTF-8（不是
Convert to UTF-8，后者会改内容） - 再分别点击右下角换行符标识 → 选 Convert Line Endings → Unix (LF)
- 如果仍第一行全红，大概率是其中一个含 BOM：用 File → Save with Encoding → UTF-8（这个操作会剥离 BOM）
- 缩进混用（Tab vs Space）也会触发整行差异：对比前按
Ctrl+Shift+P→ 输入Convert Indentation to Spaces统一处理
大文件卡死不是插件问题，而是 Sublime 渲染机制限制
手动安装不能绕过 Sublime Text 的底层渲染瓶颈。超过 5000 行或含超长单行（如 base64、压缩 JSON）时，视图刷新会明显延迟甚至无响应。
- 临时方案：按
Ctrl+Shift+P→ 输入Set Syntax: Plain Text，关闭语法高亮可提速 - 别强行对比 >10MB 文件——这不是插件缺陷，是 Sublime API 本身不支持高效大文本 diff 渲染
- 真要处理这类场景，建议用命令行：
diff -u file1.js file2.js | head -n 50快速定位变更范围，再回到 Sublime 精读关键段
Reopen with Encoding。 
