SideBarEnhancements 在 Sublime Text 4 中仍然可以正常使用，但安装方法一定不能出错——必须通过 Package Control 安装，否则就像把假币塞进自动售货机，完全不会生效。很多用户习惯手动把 ZIP 文件拖到 Packages/ 目录，结果右键菜单始终不显示，甚至连报错提示都没有，几乎属于“静默失效”。这是因为 Sublime Text 4 对插件签名和目录结构校验比以前严格得多，手动解压的插件包通常会被直接忽略，而且不会给出明显提示。
因此，安装 SideBarEnhancements 的唯一可靠方法就是使用 Package Control。它不仅负责下载安装，还会处理路径注入、依赖解析以及插件激活注册，这几个步骤缺一不可。
用 Package Control 安装是唯一可靠方式
首先确认 Package Control 已经正确安装：按 Ctrl+Shift+P（Windows/Linux）或 Cmd+Shift+P（macOS），输入 Package Control: Install Package，命令能够正常响应才说明安装成功。如果命令面板没有反应，就需要重新安装 Package Control：按 Ctrl+` 打开控制台，粘贴官网最新的安装脚本（2026 年可用版本通常以 import urllib.request 开头）。
- 执行
Package Control: Install Package→ 等待状态栏显示“Loading packages…”并完成加载 → 输入SideBarEnhancements（注意大小写和拼写，不能写成sidebarenhancement或带下划线的其他变体）→ 回车安装 - 安装完成后一般不需要重启 Sublime Text，几秒钟内右键侧边栏文件夹就能看到
New File、Copy Path、Open in Terminal等增强菜单选项
右键菜单不出现？先检查项目绑定和 ignored_packages
如果 SideBarEnhancements 已经安装成功，但右键菜单没有变化，大多数情况下是因为 Sublime Text 没有把当前目录识别为“有效上下文”。需要注意的是，SideBarEnhancements 只会对明确添加到项目中的文件夹生效，并不是所有拖进窗口的目录都会被识别。
- 必须通过
Project → Add Folder to Project…添加目标目录；仅仅“拖文件夹进窗口”或“双击打开单个文件”通常不会触发增强右键菜单 - 检查
Preferences → Settings – User中是否包含"ignored_packages": ["SideBarEnhancements"]，如果有，需要将其删除 - 检查
Preferences → Browse Packages…打开的目录中，SideBarEnhancements/文件夹是否存在且内容完整（不能带有.disabled后缀） - Windows 用户还要注意：尽量不要把项目放在
C:\Program Files\或其他受系统保护、受控的文件夹中——系统可能会静默拒绝写入，导致New File弹窗一闪而过或创建失败
macOS 上 Open in Terminal 失效？不是插件问题，是 PATH 没暴露给 GUI
在 macOS 中点击 Open in Terminal 后没有反应，通常并不是 SideBarEnhancements 插件损坏，而是因为 Sublime Text 作为 GUI 应用启动时，无法继承 shell 环境中的 PATH，从而找不到 terminal 或 iterm2 命令。可以先做一个简单验证：在终端中运行 which iTerm2 或 which terminal，确认对应命令确实存在。
常见修复方法有两种：
- 推荐做法：在
Preferences → Package Settings → SideBarEnhancements → Settings – User中添加：{ "open_in_terminal": { "cmd": ["/usr/bin/open", "-a", "iTerm2", "--args", "-w", "-d", "$file_path"] } } - 或者直接使用终端程序的绝对路径启动，这样可以避免依赖
PATH环境变量查找 - 不要修改
Default目录下的默认配置文件，只修改User目录中的用户配置副本即可
功能点错位置就失效：右键对象必须是文件夹节点
SideBarEnhancements 的大部分功能，例如 New File、Open in Terminal 等，只会响应侧边栏文件夹节点上的右键操作。如果你对单个文件（例如 index.html）或者空白区域右键，这些菜单项通常不会显示。
- 即使项目已经正确添加，右键单独打开的文件标签页，也不会弹出 SideBarEnhancements 的增强菜单
- 如果想在某个子目录下新建文件，必须右键该子目录本身，而不是父级目录或某个文件
Copy Relative Path需要依赖项目根路径来计算；如果当前目录没有绑定到项目，它可能会退化为普通Copy Path，甚至直接返回空值- 批量
Rename功能要求至少选中两个文件，并且模板中必须包含{{index}}或{{name}}，否则多个文件可能会被重命名成同一个名称，并触发覆盖警告
最容易被忽略的问题其实就是“上下文是否有效”。SideBarEnhancements 本身非常稳定，但它的功能行为完全依赖 Sublime Text 的项目模型。一旦路径没有正确绑定、权限不足，或者右键的对象类型不符合要求，插件功能就会静默降级——不会主动报错，只会表现为菜单消失、命令不显示或操作没有响应。理解这一点，往往能大幅减少排查和修复问题的时间。
