SideBarEnhancements右键没反应，需先通过Project→Add Folder to Project…显式添加文件夹到项目；侧边栏背景色修改须在启用的.sublime-theme中调整"sidebar_container"的layer0.tint为三元整数数组且opacity为1.0；FileIcons图标显示依赖主题支持及正确启用；New File弹窗闪退多因路径无写入权限或未加入项目。
SideBarEnhancements装完右键没反应？先确认项目绑定
插件装完但右键菜单不出现，90% 是因为 Sublime 根本没把当前目录当“项目”。它不会自动把拖进来的文件夹或双击打开的单个文件纳入上下文——必须显式执行 Project → Add Folder to Project…。这个动作才是触发所有右键功能（New File、Copy Path、Open in Terminal）的硬性开关。如果只是把文件夹拖进窗口、或用 File → Open Folder，菜单项永远是灰色或干脆不显示。
侧边栏背景色改了没生效？别碰 Preferences.sublime-settings
在 Preferences → Settings – User 里写 "sidebar_background": "#2d2d2d" 完全无效。Sublime Text 4 的侧边栏背景只读取当前启用的 .sublime-theme 文件中 "class": "sidebar_container" 的 layer0.tint 字段，且必须是长度为 3 的整数数组，比如 [45, 45, 45]。改错位置、写成十六进制或 rgb() 都不会生效。同时要确保 layer0.opacity 是 1.0，否则颜色会被透明度稀释。
想让文件名带彩色图标？FileIcons + 主题必须配对启用
FileIcons 插件本身不显示图标，它只提供图标映射逻辑；真正渲染图标的，是 UI 主题里的 "class": "icon_file" 规则。所以光装 FileIcons 不够，还得：① 安装支持图标的主题（如 Material Theme 或 ayu-dark.sublime-theme）；② 在 Settings – User 中明确指定 "theme": "Material-Theme.sublime-theme"；③ 确保主题内启用了图标占位（默认 Material Theme 已开，Adaptive 则完全不预留空间）。漏掉任何一环，图标就只显示为小方块或直接空白。
新建文件弹窗一闪而过？检查路径写入权限和项目根识别
New File 点击后弹窗瞬间消失，不是插件崩溃，而是 Sublime 尝试创建文件时失败并快速退出。常见原因有三个：
- 目标文件夹未通过
Project → Add Folder to Project…加入项目（最常见） - 路径位于
C:\Program Files\或 macOS 受控目录下，系统静默拒绝写入 - 路径含空格或括号（如
my project (v2)），部分 Windows 版本 shell 解析异常
