必须用 Package Control 安装SideBarEnhancements，手动解压ZIP会因签名校验、路径注入和依赖处理缺失而彻底失效；安装后需将文件夹通过Project → Add Folder to Project…加入项目才生效，且路径不能含空格或中文。
必须用 Package Control 安装，手动解压 ZIP 会彻底失效
SideBarEnhancements 插件在 Sublime Text 4（当前主流版本）中已不接受未签名或结构不合规的插件包，手动下载 ZIP、解压到 Packages 目录后，插件几乎必然不加载——右键菜单毫无变化，插件设置也打不开，Preferences → Package Settings 里根本找不到它。
Package Control 不只是“安装工具”，它负责校验签名、解压到正确路径、注入激活逻辑、处理依赖（比如某些功能依赖 Default 包里的上下文菜单规则），这些是手动操作完全无法替代的。
- 确认已装 Package Control：按
Ctrl+Shift+P（Win/Linux）或Cmd+Shift+P（macOS），输入Package Control: Install Package能响应才算成功 - 若命令面板无反应，说明 Package Control 损坏或未装，需重跑官方安装脚本（控制台粘贴并执行）
- 安装时输入
SideBarEnhancements要拼写准确，注意大小写和空格——搜sidebar或sidebarenhancement都找不到 - 安装完成后无需重启，几秒内右键侧边栏文件/文件夹就能看到新选项
右键菜单没出现？大概率是项目未绑定或插件冲突
即使安装成功，右键仍可能只有原生选项（Open、Copy Path），没有 New File、Open in Terminal 等——这不是插件坏了，而是 Sublime 没把当前目录识别为“有效上下文”。
SideBarEnhancements 的菜单项只对「已加入项目」的文件夹生效。直接拖一个文件夹进 Sublime 窗口，它只是被打开，但不属于项目；而 Project → Add Folder to Project… 才真正注册路径权限。
- Windows 用户若目标路径在
C:\Program Files\或受控文件夹下，系统会静默拒绝写入，New File点击后弹窗一闪即逝 - 检查是否有其他插件劫持右键逻辑，比如
AdvancedNewFile、GitSavvy或旧版FileDiffs，临时禁用它们再测试 - 打开
Preferences → Browse Packages…，确认SideBarEnhancements文件夹存在且非空，且不带.disabled后缀 - Sublime Text 4 用户务必确保插件版本 ≥
4.0.0（Package Control 当前提供的是v3.1.0，已适配 ST4 build ≥ 4165）
Open in Browser 打不开 HTML？路径含空格或中文是主因
点击 Open in Browser 后浏览器只打开空白页、报 ERR_FILE_NOT_FOUND，或者根本没反应——90% 是因为文件路径里有空格、括号或中文字符，而默认调用命令没做 URL 编码或引号包裹。
这不是浏览器问题，也不是插件 bug，是系统级路径传递缺陷。Sublime 传参给浏览器时若未转义，file:///C:/my project/index.html 会被截断成 file:///C:/my，自然找不到文件。
- 最稳妥的临时解法：把项目移到无空格、无中文的路径下，例如
C:\dev\myapp\ - 进阶配置：在
Preferences → Package Settings → SideBarEnhancements → Key Bindings – User中添加自定义快捷键，强制用file://协议并启用编码：[ { "keys": ["alt+b"], "command": "side_bar_open_in_browser", "args": {"encoding": "utf-8", "paths": []} } ] - 更稳定方案：改用
side_bar_files_open_with并指定浏览器命令行参数，比如 Chrome 的--app=file://...，绕过系统默认 handler
想显示文件图标？AFileIcon + 主题开关缺一不可
SideBarEnhancements 本身不提供图标，它只增强菜单；要让侧边栏出现 .py、.js 等彩色图标，必须配合 AFileIcon 插件 + 支持图标的 UI 主题 + 手动开启开关。
很多人装了 AFileIcon 却看不到图标，是因为还在用默认的 Default.sublime-theme——它压根没预留图标占位区，插件数据注入了也渲染不出来。
- 先装主题：推荐轻量自带的
Adaptive.sublime-theme（Preferences → Theme → Adaptive.sublime-theme） - 再装插件：通过 Package Control 安装
AFileIcon，然后按Ctrl+Shift+P运行AFileIcon: Enable Icons - 手动验证：打开
Preferences → Settings – User，确保顶层有"file_icons": true，不能嵌套在"theme"或其他对象里 - 图标灰白？检查是否误启用了
"draw_white_icons": true，设为false即可
最容易被忽略的一点：所有配置项都别乱动。SideBarEnhancements 开箱即用，90% 的“失效”问题，都源于在设置里加了错误的 JSON 结构，或者覆盖了关键默认值。先确认基础流程走通，再考虑定制。
