sidebarenhancements插件需通过package control安装并显式添加文件夹到项目才能启用右键功能,否则new file等操作无效;须检查禁用配置、路径权限及context.sublime-menu文件规范。

SideBarEnhancements 是唯一真正补全 Sublime Text 侧边栏右键功能的插件,原生不支持 New File、Copy Path、Open in Terminal 等操作。装完就生效?不是——90% 的“右键没反应”问题,都卡在安装后那三步硬性验证上。
必须用 Package Control 安装,手动拖 ZIP 会彻底失效
Sublime Text 4(当前主流版本)会拒绝加载未签名或结构不合规的包。SideBarEnhancements 的官方仓库虽已归档,但 Package Control 仍维护着适配 ST4 的 v3.1.0 版本,且通过签名校验。
- 按
Ctrl+Shift+P(Win/Linux)或Cmd+Shift+P(macOS)调出命令面板 - 输入
Package Control: Install Package并回车;若无响应,说明Package Control损坏或未装,需重跑官方安装脚本 - 等状态栏 “Loading packages…” 消失后,输入
SideBarEnhancements(注意:S 和 B 大写、无空格、无下划线、不能拼成sidebarenhancement) - 选中后回车,状态栏显示
Installing package: SideBarEnhancements即开始安装,几秒后自动完成,无需重启
右键菜单不出现?检查这三步缺一不可
插件装完 ≠ 功能可用。它只对「显式加入项目」的文件夹节点生效,其他任何方式加载目录都不触发上下文菜单。
- 必须通过
Project → Add Folder to Project…显式添加目标文件夹——不是拖进窗口,不是File → Open Folder - 检查
Preferences → Settings – User中是否含"ignored_packages": ["SideBarEnhancements"],有就整行删掉;同时检查项目级配置(.sublime-project)里是否也写了同名禁用项 - 右键对象必须是侧边栏里的文件夹节点(哪怕只是项目根目录),对单个打开的文件(如
index.html)右键无效,对空白处右键也无效
New File 弹窗一闪而过?本质是路径不可写或项目未识别
这不是插件崩溃,而是 Sublime 尝试创建文件时因权限或上下文缺失而快速退出。插件只调用原生接口,不控制弹窗生命周期。
- 确认已执行
Project → Add Folder to Project…——这是触发New File的唯一上下文开关 - 验证目标文件夹写入权限:
Windows右键文件夹 → 属性 → 安全 → 当前用户勾选“写入”;macOS/Linux执行ls -ld /path/to/folder,确认权限含w位 - 避开
C:\Program Files\或系统受控路径;开发目录建议放在C:\Users\YourName\dev\或~/dev/ - 路径含中文、空格或括号(如
my project (v2))可能触发 shell 解析异常,先改纯英文无空格路径测试
想加自定义右键项?Context.sublime-menu 路径和编码必须严丝合缝
所有侧边栏右键菜单项最终由 Packages/Context.sublime-menu 控制,放错位置、命名错误、编码带 BOM 都会导致整个文件静默失效。
- 文件名必须是
Context.sublime-menu(C 大写,无空格,无 .txt 后缀) - Windows 正确路径:
%APPDATA%\Sublime Text\Packages\Context.sublime-menu;macOS:~/Library/Application Support/Sublime Text/Packages/Context.sublime-menu;Linux:~/.config/sublime-text/Packages/Context.sublime-menu - 保存为 UTF-8 编码,禁用 BOM
- 限定只在侧边栏 + 文件夹节点生效,
context字段至少包含:{"key": "node_type", "operand": "sidebar"}和{"key": "is_folder", "operator": "equal", "operand": true}











