sidebarenhancements必须通过package control安装v3.1.0版本，且需显式添加文件夹至项目、清除禁用配置、右键文件夹节点三步验证才能启用新建文件等功能。
SideBarEnhancements 必须用 Package Control 安装
手动解压 ZIP、拖 .sublime-package 文件、或从 GitHub 克隆到 Packages 目录，全都会失效。ST4（build ≥ 4165）强制校验签名和加载路径，跳过 Package Control 就等于没注册——Preferences → Package Settings 里根本找不到它，右键菜单也完全空白。
实操步骤很明确：
- 按
Ctrl+Shift+P（Win/Linux）或Cmd+Shift+P（macOS）调出命令面板 - 输入
Package Control: Install Package并回车；若无响应，说明 Package Control 损坏或未装，需重跑官方安装脚本 - 等状态栏 “Loading packages…” 消失后，输入
SideBarEnhancements（注意：S 和 B 大写、无空格、无下划线、不能少字母） - 选中后回车，状态栏显示
Installing package: SideBarEnhancements即开始安装，几秒后自动完成，无需重启
右键菜单不出现？三步硬性条件缺一不可
插件装完 ≠ 功能可用。90% 的“右键没反应”问题，卡在这三个不可绕过的环节上：
- 必须通过
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…——这是唯一触发side_bar_new_file命令的上下文开关 - 验证目标文件夹写入权限：
Windows右键文件夹 → 属性 → 安全 → 当前用户勾选“写入”；macOS/Linux执行ls -ld /path/to/folder查看权限位 - 避免路径含中文、空格或括号（如
my project (v2)），临时改用纯英文无空格路径测试，排除 shell 解析异常
想自定义右键菜单？Context.sublime-menu 路径和编码必须精准
Sublime 不支持“安装 CustomSidebar”这种插件——所谓自定义，其实是靠 SideBarEnhancements 提供基础命令 + 手动配置 Context.sublime-menu 实现。
关键细节极易出错：
-
Context.sublime-menu必须放在Packages/根目录下（不是Packages/User/），Windows 路径为%APPDATA%\Sublime Text\Packages\Context.sublime-menu - 文件名必须是
Context.sublime-menu（C 大写、无空格、无 .txt 后缀），保存为 UTF-8 编码且**禁用 BOM**，带 BOM 会导致整个文件静默失效 -
context条件必须写全：{"key": "is_folder", "operator": "equal", "operand": true}控制只对文件夹生效；{"key": "selection_empty", "operator": "equal", "operand": false}确保用户点了节点而非空白处
最常被忽略的是：所有自定义菜单项都依赖 SideBarEnhancements 注入的命令名（如 side_bar_new_file），拼错一个字母，菜单项就彻底隐身，且 Sublime 不报任何错误。
