SideBarEnhancements 必须通过 Package Control 安装，手动解压至 Packages 目录会因绕过 Python 运行时适配和更新机制导致 import 失败、菜单空白；它仅对显式添加到项目的目录生效，且浏览器路径、图标显示等均需严格配置。
SideBarEnhancements 必须通过 Package Control 安装，手动放文件进 Packages 目录会失效
它不是独立插件包，而是依赖 Sublime 的 Python 运行时和 Package Control 的更新机制。2026 年的 ST4（build ≥ 4165）已全面使用 Python 3.8+，手动解压 GitHub 仓库到 Packages/ 会导致 import 失败、右键菜单空白、甚至配置项不加载——因为社区维护版（v3.0.1+）做了运行时适配，而源码直装绕过了这一层校验。
- 先确认
Ctrl+Shift+P（Win/Linux）或Cmd+Shift+P（macOS）能调出命令面板；若无反应，说明 Package Control 损坏或未安装 - 打开控制台（
Ctrl+`），粘贴官网最新安装脚本（以import urllib.request开头，2026 年有效），回车执行 - 看到右下角提示
Package Control installed后，再按Ctrl+Shift+P输入Package Control: Install Package，确认列表能正常加载
安装后右键没反应？大概率是项目没加进去，不是插件坏了
SideBarEnhancements 只对「已加入项目的目录」生效。直接双击打开单个 index.html，或拖一个文件夹到窗口但没走 Project → Add Folder to Project…，右键就永远看不到 New File 或 Open in Terminal——这不是 bug，是设计逻辑：它需要明确的项目根路径来计算相对路径、判断权限、生成上下文菜单项。
- 用
Project → Add Folder to Project…显式添加你的开发目录（比如C:UsersYourNamedevmy-app） - 避免把项目放在
C:Program Files或 macOS 的受保护系统路径下，Windows 会静默拒绝写入，导致New File点击后弹窗一闪而过 - macOS/Linux 用户若遇到
Unable to find command: find，说明终端环境变量没加载，可在Preferences → Settings – User中加一行："shell_cmd": "/bin/bash -l -c "find …""
想用右键打开 HTML？浏览器路径写错一个斜杠就失败
自定义浏览器预览时，Preferences → Package Settings → SideBarEnhancements → Settings – User 里的 browser 字段必须严格匹配系统实际路径，且格式敏感。单反斜杠 在 JSON 中会被转义，正斜杠 / 或双反斜杠 \ 才安全；macOS 路径含空格时虽不用手动加引号，但必须写全路径（如 /Applications/Microsoft Edge.app/Contents/MacOS/Microsoft Edge）。
- Windows 示例（正确）：
"browser": "C:/Program Files/Microsoft/Edge/Application/msedge.exe" - Windows 示例（错误）：
"browser": "C:Program FilesMicrosoftEdgeApplicationmsedge.exe"（P和M会被解释为转义字符） - macOS 示例（正确）：
"browser": "/Applications/Google Chrome.app/Contents/MacOS/Google Chrome"
图标不显示？AFileIcon 和主题开关是两回事，别混在一起查
SideBarEnhancements 只管菜单，不管图标。要让侧边栏出现彩色文件图标，得靠 AFileIcon 插件 + 支持图标的 UI 主题（如 Adaptive.sublime-theme）+ 手动开启开关三者同时满足。很多人装了 AFileIcon 就以为完事了，结果还用着默认的 Default.sublime-theme，这个主题压根没预留图标占位区，装了也白搭。
- 先确认当前主题是
Adaptive或ayu（Ctrl+Shift+P→ 输入UI Theme→ 选Set UI Theme） - 再在
Preferences → Settings – User中加顶层字段："file_icons": true（不是嵌套在"theme"里） - 如果图标仍是灰白，检查是否误启了
"draw_white_icons": true，设为false即可
SideBarEnhancements 控制，图标渲染由 AFileIcon 和主题共同决定，项目上下文是所有操作的前提。漏掉其中任何一环，都会表现为“没反应”——而这恰恰是最容易被当成插件故障去重装的地方。 
