FileDiffs插件需通过Package Control安装，且仅支持已保存的非同一文件的两个磁盘文件对比；搜索时须严格输入“FileDiffs”，乱码可切换git diff引擎或重设UTF-8编码。
FileDiffs 插件装不上？先确认 Package Control 是否正常工作
Sublime Text 本身不自带插件管理功能，FileDiffs 必须通过 Package Control 安装。如果按教程操作后没反应，大概率是 Package Control 没装好或失效了。
- 打开 Sublime →
Ctrl+Shift+P（Windows/Linux）或Cmd+Shift+P（macOS），输入Package Control: Install Package，回车——如果提示“command not found”，说明Package Control没装或损坏 - 重装
Package Control：访问https://packagecontrol.io/installation，复制对应系统的 Python 安装代码，粘贴进 Sublime 的View → Show Console（快捷键Ctrl+`），回车执行 - 安装完重启 Sublime，再试一次
Package Control: Install Package，等列表加载完成后再搜FileDiffs
搜索不到 FileDiffs？注意大小写和拼写变体
在 Package Control 搜索框里输错一个字母就找不到——它不是 FileDiff、也不是 FileDifferences，官方名称就是严格大小写的 FileDiffs（末尾带 s）。
- 输入时建议直接复制粘贴：
FileDiffs - 如果搜出来多个结果（比如带 “Beta” 或 “Plus” 后缀的），只选作者是
bradleyg的那个，这是原始维护版本 - 装完不会自动弹窗，也不需要重启，但右键菜单里会立刻多出
FileDiffs子项
右键没出现对比选项？检查文件是否已保存且非临时缓冲区
FileDiffs 只对已保存的磁盘文件生效，未保存的 Untitled 标签页、或从命令行用 subl -n 打开的空缓冲区，右键不会显示对比入口。
- 两个待比对的文件都必须已保存（有真实路径，状态栏显示文件名+路径）
- 不能是同一文件的两个标签页（比如分屏看同一个
index.js），必须是两个不同路径的文件 - 如果右键只有灰色不可点的
Diff with saved，说明当前文件还没存盘，先Ctrl+S - 支持跨项目对比，比如左边是
/project-a/src/util.js，右边是/project-b/src/util.js
对比结果乱码或显示不全？调整 diff 引擎和编码设置
默认用内置 diff，遇到大文件（>1MB）、含中文或特殊符号时容易卡顿或丢内容。这不是插件 bug，而是 Sublime 默认行为限制。
- 打开
Preferences → Package Settings → FileDiffs → Settings，在用户配置里加一行："diff_tool": "git"（前提是系统已装 Git 并加入 PATH） - 若仍乱码，检查文件编码：右下角点击编码名（如
UTF-8），选Reopen with Encoding → UTF-8，再对比 - Git diff 更稳定，但不支持实时高亮差异块；原生 diff 响应快，但超 5000 行可能截断
真正卡住的点往往不是插件本身，而是没意识到它依赖已保存文件、依赖 Package Control 状态、以及默认 diff 工具的边界。多试一次保存，多看一眼右下角编码，比重装插件管用得多。
