必须从官方源安装Sublime Text，否则PackageControl会拒绝加载FileDiffs等签名验证插件；Linux用APT官方源，Windows/macOS仅认准官网或GitHub Release；Compare Side-by-Side（小写b）才是当前维护版，支持同步滚动与差异复制。
Sublime Text 安装必须走官方源，否则插件加载会失败
直接从第三方“汉化版”或“绿色便携包”安装，PackageControl 会拒绝加载 FileDiffs、Compare Side-by-Side 等依赖签名验证的插件——报错信息通常是 Unable to load plugin: FileDiffs 或静默不生效。官方二进制包自带签名机制，而篡改过的包会破坏 .sublime-package 的校验链。
Linux 用户请用 APT 官方源（非 Ubuntu 默认仓库）：wget -qO - https://download.sublimetext.com/sublimehq-pub.gpg | sudo tee /etc/apt/keyrings/sublimehq-pub.asc > /dev/nullecho "deb [signed-by=/etc/apt/keyrings/sublimehq-pub.asc] https://download.sublimetext.com/ apt/stable/" | sudo tee /etc/apt/sources.list.d/sublime-text.listsudo apt update && sudo apt install sublime-text
Windows/macOS 用户只认准两个地址：
– 官网 https://www.sublimetext.com/
– GitHub Release 页面 https://github.com/sublimehq/sublime_text/releases
对比插件选 Compare Side-by-Side，不是 Compare Side-By-Side 或 Sublimerge
插件名带空格和连字符的细微差别直接影响功能：搜 Compare Side-By-Side（带大写 B 和短横）会装到已停更的旧版，右键菜单无响应；搜 Compare Side-by-Side（小写 b 和短横）才是当前维护版本，支持同步滚动、逻辑行对齐、一键复制差异块。
安装后无需重启，验证方式：
– 打开两个文本文件
– 右键任一标签页 → 出现 Compare Side by Side 菜单项
– 或按快捷键：Ctrl+Alt+C（Windows/Linux）、Cmd+Alt+C（macOS）
注意：
– 不支持未保存的临时标签页之间对比（要用 Diffy）
– 不支持三路合并、导出 patch、文件夹内容比对
– 差异高亮是纯行级，不感知语法结构
FileDiffs 配置外部工具时，路径权限和空格必须显式处理
想调 meld 或 WinMerge 做可视化比对？FileDiffs 的配置项 external_diff_command 很容易因路径问题失效：
- Linux/macOS：命令必须可被 shell 直接执行，
which meld返回路径要填进FileDiffs.sublime-settings，不能只写meld - Windows：含空格路径必须加英文双引号，例如
"C:\Program Files\WinMerge\WinMergeU.exe"，漏掉引号会导致启动失败且无提示 - 所有平台：确保对比工具二进制有执行权限（
chmod +x），尤其手动下载的meld二进制
配置示例（Linux）：
{
"external_diff_command": "/usr/bin/meld"
}
双向实时比对不存在，所谓“实时”其实是手动触发 + 快速刷新
Sublime Text 所有对比插件都不监听文件系统变化，没有真正的“双向实时”能力。所谓“实时”，是指你在保存文件后，手动再按一次 Ctrl+Alt+C 或右键重选 Compare Side by Side，它会立刻重新读取磁盘内容并刷新视图。
这意味着：
– 修改左边文件后，右边不会自动更新，必须手动重对比
– 没有类似 VS Code 的 Watch file changes 开关
– 如果你真需要自动响应变更，得配合 inotifywait（Linux）或 fswatch（macOS）写脚本调用 subl --command，但 Sublime 自身不提供该接口
最容易被忽略的一点：对比窗口关闭后，差异状态完全丢弃，不缓存、不记录、不生成临时文件——这不是 bug，是设计选择。别指望它替代 git diff 或专业 diff 工具的持久化能力。
