FileDiffs插件装不上主因是Package Control未安装成功；装上后无法对比则因两文件未同时满足已保存、路径不同、编码与换行符统一这三项硬性条件。
FileDiffs 插件装不上，90% 是 Package Control 没跑起来；装上了比不了，90% 是两个文件没同时满足“已保存、路径不同、编码和换行符统一”这三条硬条件。
Package Control 没反应？先让它真正工作
Sublime Text 原生不带插件管理，Package Control 是唯一正经渠道。如果按 Ctrl+Shift+P 输入 Package Control: Install Package 后报 command not found，说明它根本没装好。
- 按
Ctrl+`（Windows/Linux）或Cmd+`（macOS）打开控制台 - 粘贴官网安装代码（来自
packagecontrol.io/installation），回车执行 - 必须重启 Sublime Text，再试一次命令面板搜索
搜不到 FileDiffs？拼写和大小写卡死你
装完 Package Control 后，命令面板里搜 FileDiffs 时，末尾的 s 和大小写都敏感——输成 FileDiff、filediffs 或 FileDifferences 都找不到。
- 在命令面板中严格输入：
FileDiffs - 别用侧边栏右键 → Install Package —— 这个入口不走
Package Control，容易装错包 - 手动下载 ZIP 放进
Packages/目录？路径含中文、放错层级（比如放到Packages/User/下）、权限不对，都会导致插件静默失效
右键没菜单？文件根本没“被插件看见”
FileDiffs 只认有真实磁盘路径的已保存文件，对 Untitled-1、未保存副本、同一文件分屏打开完全无视。
- 两个标签页右下角都必须显示完整路径（如
/project/src/config.json），不能是Untitled - 不能是同一个文件被左右分屏打开（比如左右都是
index.js） - 侧边栏右键无效——必须先点击任一已打开的标签页，让它成为活动视图，再右键
- 右键菜单里只有灰色不可点的
Diff with saved？说明当前文件还没存盘，先按Ctrl+S
对比结果全是红块绿块、中文变方块？不是 bug，是字节流在打架
FileDiffs 不做任何编码转换或换行符归一化，它比的是 Sublime 当前加载进内存的原始字节流。一个 UTF-8 with BOM，一个 GBK，一个 CRLF，一个 LF，就会整段误标差异。
- 逐个打开待比文件 → 右下角点击编码名（如
UTF-8 with BOM）→Reopen with Encoding→UTF-8 - 再点右下角换行符标识（如
Windows (CRLF)）→Convert Line Endings→Unix (LF) - 缩进敏感格式（如
YAML、Markdown）建议再执行Convert Indent to Spaces - 仍乱码？可在
Preferences → Package Settings → FileDiffs → Settings中加配置："diff_tool": "git"（需系统已装 Git 并加入 PATH）
最常被忽略的一点：默认输出是单标签页的纯文本 diff，不是左右并排视图。想并排看，得先拆栏、再拖拽——这个动作没有快捷键绑定，必须手动干预布局。
