SideBarEnhancements 在 Sublime Text 3 上必须通过 Package Control 安装,手动方式均失败;需先确保 Package Control 正常运行,再安装插件,并通过 Project → Add Folder to Project… 添加文件夹、清除 ignored_packages 设置、右键文件夹节点才能启用功能。

SideBarEnhancements 在 Sublime Text 3 上完全可用,但必须走 Package Control 安装流程——手动解压 ZIP、拖进 Packages/ 目录、双击 .sublime-package 文件,这三种方式都会失败。
必须用 Package Control 安装,且不能跳过初始化等待
SideBarEnhancements 依赖 Package Control 的签名校验、Python 运行时注入和菜单上下文注册。ST3 虽不强制要求 v3.0.1+(如 ST4 那样),但旧版手动包仍会因结构不合规被忽略。
安装前先确认 Package Control 已就位:按 Ctrl+Shift+P 输入 Package Control: Install Package,能响应才算成功。
若无响应:
- 按 Ctrl+` 调出控制台
- 粘贴官网最新安装脚本(以 import urllib.request 开头)并回车
- 等右下角提示 “Package Control installed”,再重试
安装时注意:
- 输入
SideBarEnhancements(S 和 B 大写,无空格、无下划线、无连字符) - 等状态栏显示 “Loading packages…” 消失后再输,否则搜不到
- 回车后看到 “Installing package: SideBarEnhancements”,即表示开始安装,无需重启
右键菜单不出现?验证三个硬性条件
插件装完 ≠ 功能可用。90% 的“没反应”问题卡在这三点:
- 必须通过 Project → Add Folder to Project… 显式添加文件夹——拖进去、双击打开、File → Open Folder 全都不算
- 检查 Preferences → Settings – User 中是否含 "ignored_packages": ["SideBarEnhancements"],有就整行删掉
- 右键对象必须是侧边栏里的**文件夹节点**(哪怕只是根目录),对单个打开的 index.html 或空白处右键无效
ST3 用户额外注意:
- 不要从 GitHub
master分支 clone,那已适配 ST5 预览版,ST3 会报ImportError: No module named 'sublime_plugin' - 推荐版本是 v3.2.1(Package Control 当前提供),兼容 ST3 所有稳定 build
New File 弹窗一闪而过?本质是路径未识别或不可写
这不是插件 bug,是 Sublime 尝试调用原生新建接口时失败后快速退出。
必须同时满足:
- 已执行 Project → Add Folder to Project… 添加目标目录(这是唯一触发逻辑的开关)
- 目标文件夹有完整写入权限:Windows 右键 → 属性 → 安全 → 当前用户勾选“写入”;macOS/Linux 执行 ls -ld /path/to/folder 确认含 w 权限位
- 路径避免中文、空格、括号(如 my project (v2)),ST3 对 shell 路径解析更敏感,建议先用纯英文路径测试
真正容易被忽略的是:ST3 不会自动刷新侧边栏缓存。删除文件后,侧边栏仍显示旧项——必须手动按 F5 刷新,或在 Preferences → Settings – User 中加 "refresh_on_save": true。











