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 和主题共同决定,项目上下文是所有操作的前提。漏掉其中任何一环,都会表现为“没反应”——而这恰恰是最容易被当成插件故障去重装的地方。










