必须用 package control 安装 sidebarenhancements，手动解压 zip 或拖入 packages 目录会因签名和结构问题彻底失效；安装后需通过 project → add folder to project… 显式添加文件夹、确保右键目标为文件夹节点、排除 ignored_packages 禁用项，三者缺一不可。
SideBarEnhancements 必须走 Package Control 安装
手动拖 ZIP、解压到 Packages 目录、甚至用 subl . 命令加载，全都不生效——Sublime Text 4（build ≥ 4165）已拒绝加载未签名或结构不合规的插件包。SideBarEnhancements 当前维护版本是 v3.1.0，只通过 Package Control 分发。
操作路径很窄，但必须严格：按 Ctrl+Shift+P（Windows/Linux）或 Cmd+Shift+P（macOS）→ 输入 Package Control: Install Package → 等状态栏出现 “Loading packages…” 消失 → 输入 SideBarEnhancements（注意 S 和 B 大写、无空格、无下划线）→ 回车。
常见卡点：
- 命令面板无响应？说明
Package Control损坏或未安装，别继续搜插件，先重装官方脚本 - 输入后空白/报错
There are no packages available？大概率是公司防火墙或杀毒软件拦截了packagecontrol.io - 安装完状态栏显示
Installing package: SideBarEnhancements即成功，无需重启
右键菜单不出现？检查项目上下文三要素
装完插件 ≠ 功能就绪。90% 的“右键没反应”问题，都因缺失项目上下文。它只对「显式加入项目的文件夹节点」生效，不是对任意打开的文件，也不是对拖进来的文件夹。
必须完成这三步验证：
- 用
Project → Add Folder to Project…显式添加目标目录（不能用File → Open Folder…替代） - 检查
Preferences → Settings – User中是否含"ignored_packages": ["SideBarEnhancements"]，有就整行删掉；同时扫一眼项目配置.sublime-project文件里有没有同名禁用项 - 右键对象必须是侧边栏里的**文件夹节点**（哪怕只是根目录），对单个打开的
index.html右键无效，对空白处右键也无效
Windows 用户额外注意：C:\Program Files 或系统受控路径下，New File 会因权限静默失败——开发目录请放在 C:\Users\YourName\dev 这类用户可写路径。
New File 弹窗一闪而过？本质是路径不可写或项目未识别
这不是插件 bug，是 Sublime 在调用原生新建逻辑时发现目标路径无法写入，于是快速退出弹窗。只要满足两个硬性条件，弹窗就会稳定停留供你输入文件名。
缺一不可：
- 已执行
Project → Add Folder to Project…添加了目标目录（这是唯一触发New File逻辑的开关） - 目标文件夹有完整写入权限：Windows 右键 → 属性 → 安全 → 当前用户勾选“写入”；macOS/Linux 执行
ls -ld /path/to/folder，确认输出含drwxr-xr-x且当前用户有w权限 - 路径避免中文、空格、括号等特殊字符（如
my project (v2)），临时改纯英文路径测试可快速定位是否为 shell 解析异常
别碰 Preferences → Package Settings → SideBarEnhancements → Settings：90% 的自定义配置会覆盖默认行为，直接导致 New File 按钮消失。
AFileIcon 和 SideBarEnhancements 能共存吗？能，但图标要单独配
可以一起用，而且推荐组合：一个管功能（SideBarEnhancements），一个管视觉（AFileIcon），职责分离、互不干扰。但 AFileIcon 不是装完就出图标，它依赖三件事同时成立：CSS class 注入 + 主题支持 + 用户显式启用。
关键动作：
- 安装
AFileIcon后，必须手动运行A File Icon: Rebuild Icons（通过命令面板），否则 class 根本不注入 - 主题必须启用图标渲染：要么选
AFileIcon Dark.sublime-theme这类专用主题，要么用Adaptive.sublime-theme并在Settings – User顶层加"file_icons": true - 检查
ignored_packages是否误含"Default"或"Theme - Default"——这会让主题资源加载中断，图标 class 失效
冷门扩展名（如 .toml、.env）没图标，不是插件漏了，是你没告诉它该映射哪个内置 icon 名（比如 config 或 ignore）。
