compare side-by-side手动安装必须将解压后的文件夹直接放入packages目录(非installed packages),否则插件不加载;需统一两文件编码为utf-8、换行符为lf、剥离bom,否则整行误标红。

Compare Side-By-Side 插件手动安装必须放对目录
插件不加载?八成是装进了 Installed Packages 目录。这个插件不走 Package Control 流程,手动安装时必须把解压后的文件夹直接扔进 Packages 目录(不是 Installed Packages),否则 Sublime 根本不会扫描它。
确认路径的方法:菜单 Preferences → Browse Packages…,Windows 路径通常是 %APPDATA%Sublime Text 3Packages,macOS 是 ~/Library/Application Support/Sublime Text 3/Packages/。下载的 GitHub 仓库 ZIP(注意是 Compare Side-By-Side,不是 CompareSideBySide 等变体)解压后,得到一个文件夹,把它整个复制进去——不要套娃,别再建一层子文件夹。
EditorConfig-Sublime 手动安装需注意仓库名与路径结构
手动安装 EditorConfig-Sublime 时,git clone 的地址必须是官方镜像:https://gitcode.com/gh_mirrors/ed/editorconfig-sublime。克隆完成后,里面是一个带完整 Python 模块结构的文件夹(含 editorconfig.py、sublime-editorconfig.py 等),直接把这个文件夹整体复制进 Packages 目录即可。
常见错误包括:
- 误把
editorconfig-sublime文件夹重命名为EditorConfig或加空格/横线,导致模块导入失败 - 只复制了内部的
.py文件,没保留文件夹层级,插件无法识别 - 放进
Installed Packages后重启,依然无反应——这不是配置问题,是路径错了
Compare Side-By-Side 对比前必须统一编码与换行符
手动安装的插件不做任何后台转换,所以两个文件只要存在编码、BOM 或换行符差异,就会整行标红——这不是 bug,是它如实反映字节级差异。
操作顺序不能乱:
- 先右下角点击编码名 → 选 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统一处理
HTML-CSS-JS Prettify 依赖 node.js 且路径必须显式配置
这个插件不自带 Node 运行时,必须提前装好 node,且 Sublime 默认找不到它——尤其当你没装在默认路径(如 Windows 的 C:Program Files
odejs)时。
配置方式:
- 菜单 Preferences → Package Settings → HTML/CSS/JS Prettify → Set `node` Path
- 在弹出的用户配置中填入绝对路径,例如:
"C:\Program Files\nodejs\node.exe"(Windows)或"/usr/local/bin/node"(macOS) - 保存后无需重启,但若之前报过
node not found错误,需关闭并重开当前文件标签页 - 额外注意:
newline_between_rules默认为true,会导致每个 CSS 规则后多一行;如需关闭,要进 Prettify Preferences - Default 改该字段为false
大文件卡死不是插件的问题,而是 Sublime 自身渲染机制限制,手动安装无法绕过这点。真正容易被忽略的是:所有这些插件的手动安装路径、编码处理、外部依赖路径,都必须精确到字符级——错一个斜杠、少一个引号、多一个空格,就等于白装。











