SideBarEnhancements必须通过Package Control安装,手动解压无效;需先添加文件夹到项目、确保未禁用插件、右键目标为侧边栏文件夹节点,且路径有写入权限。

SideBarEnhancements必须用Package Control装,手动拖ZIP必失效
直接解压到Packages/目录、或拖进窗口,99%不会生效。它依赖Package Control的Python运行时适配和签名校验,ST4(build ≥ 4165)已强制要求v3.0.1+版本,手动安装会触发import失败或菜单空白。
正确做法只有一步:按Ctrl+Shift+P(Win/Linux)或Cmd+Shift+P(macOS),输入Package Control: Install Package,等状态栏出现“Loading packages…”后再搜SideBarEnhancements(注意拼写:S和B大写,无空格无下划线),回车。
常见卡点:
- 命令面板无响应 → 先重装Package Control:按
Ctrl+`调出控制台,粘贴官网最新脚本(以import urllib.request开头),回车执行 - 搜不到插件 → 等几秒,首次使用需拉取远程索引;若仍无,说明网络未连通或仓库地址异常
- 状态栏显示“Installing package: SideBarEnhancements”即成功,无需重启
右键没菜单?三步验证缺一不可
装完看不到New File、Copy Path等选项,不是插件问题,是上下文缺失。必须同时满足:
- 通过
Project → Add Folder to Project…显式添加目标文件夹——拖进去、双击打开、File → Open Folder全都不算 -
Preferences → Settings – User里不能有"ignored_packages": ["SideBarEnhancements"],有就整行删掉;同时检查.sublime-project项目配置里是否也写了同名禁用项 - 右键对象必须是侧边栏里的**文件夹节点**(哪怕只是根目录),对单个打开的
index.html右键无效,对空白处右键也无效
Windows用户额外注意:C:\Program Files\或系统受控路径下,新建操作会静默拒绝,开发目录请放C:\Users\YourName\dev\这类可写位置。
New File弹窗一闪而过?本质是路径不可写
这不是插件bug,是Sublime尝试创建文件时因权限或路径识别失败而快速退出。只要满足两个硬性条件,弹窗就会稳定停留:
- 已执行
Project → Add Folder to Project…添加目标目录——这是唯一触发New File逻辑的开关 - 目标文件夹有完整写入权限:Windows右键→属性→安全→当前用户勾选“写入”;macOS/Linux执行
ls -ld /path/to/folder确认权限位含w
路径含中文、空格或括号(如my project (v2))也可能导致解析失败,建议先用纯英文无空格路径测试。
别碰Preferences → Package Settings → SideBarEnhancements → Settings——90%的自定义配置会覆盖默认行为,比如误加"disabled_commands": ["new_file"]直接禁用功能。
菜单能改,但别动Default,只改User副本
所有右键项定义在Packages/SideBarEnhancements/SideBar.sublime-menu里,支持实时编辑。但必须只改User目录下的副本(没有就复制一份过去),绝不能改Default里的同名文件。
每个菜单项是JSON对象,关键字段:
-
"caption":显示文字,如"New File" -
"command":动作名,如"side_bar_new_file" -
"enabled": false:临时禁用某项而不删除整行
改完保存,右键菜单立刻生效,无需重启。删掉某行就隐藏对应功能;加{{index}}变量可让批量重命名不覆盖(否则所有文件同名)。
真正容易被忽略的是:菜单行为依赖项目上下文,而上下文绑定只认Project → Add Folder to Project…这一种方式——其他任何“看起来像加入项目”的操作,Sublime内部都不认。


















