context.sublime-menu文件必须严格置于packages/user/目录下，命名为context.sublime-menu（utf-8无bom），json格式合法且command值与命令面板完全一致，否则菜单静默失效。
插件菜单项根本没出现在右键或 View 菜单里
不是插件没装上，是 Sublime 没把它注册进 UI 系统。常见于插件依赖的 Context.sublime-menu 或 Side Bar.sublime-menu 文件路径错、名字拼错，或 JSON 格式非法。
检查以下三点：
-
Context.sublime-menu必须放在Packages/User/目录下（Windows：%APPDATA%\Sublime Text\Packages\User\），不能放错成Packages/Default/或插件自己的目录 - 文件名必须严格为
Context.sublime-menu，不是context_menu.json、Context Menu.sublime-menu或带空格/大小写混用 - 打开该文件，确认 JSON 无语法错误：无中文逗号、无尾随逗号、所有字符串用英文双引号、
caption和command字段拼写正确
插件有菜单但只在编辑区生效，不在侧边栏或空白处显示
Sublime 的菜单作用域是隔离的：Context.sublime-menu 只影响编辑区右键；侧边栏右键由插件自带的 Side Bar.sublime-menu 控制；文件夹空白右键则完全依赖系统注册表，和 Sublime 内部菜单无关。
例如安装了 SideBarEnhancements 却看不到侧边栏菜单，原因可能是：
- 插件文件夹名不是
SideBarEnhancements（注意大小写和连字符），而是sidebar-enhancements或Side Bar Enhancements -
ignored_packages里误加了"SideBarEnhancements"，导致整个插件被跳过加载 - 插件本身未适配当前 ST 版本（如 ST4 Build ≥ 4126 要求 Python 3.8+ API），静默失败不报错
菜单能看见但点击无反应或报错 command not found
命令未定义或路径错位。Sublime 执行菜单项时，会去查找 plugin.py 中定义的 TextCommand、WindowCommand 或 ApplicationCommand 类，类名必须与 command 字段值完全一致（小写+下划线）。
典型问题包括：
-
command值写成my_custom_command，但插件里定义的是MyCustomCommand（应为my_custom_command） - 插件主文件
plugin.py里有语法错误（比如缩进错、少冒号），导致模块导入失败，命令注册中断 - 插件用了 ST3 专属 API（如
sublime.status_message()在某些旧插件中被误调用），ST4 下直接跳过加载
User 设置里 ignored_packages 误屏蔽了关键插件
这是最隐蔽的菜单消失原因。哪怕插件文件完整、路径正确、命令定义无误，只要它被列在 ignored_packages 数组里，Sublime 就会在启动时彻底跳过加载——不报错、不提示、菜单项直接蒸发。
打开 Preferences → Settings – User，检查是否存在类似这样的配置：
"ignored_packages": [
"Package Control",
"SideBarEnhancements",
"A File Icon"
]
如果插件名出现在其中，删掉对应条目，保存后重启 Sublime。特别注意："Default" 或 "Theme - Default" 也被误加进去的话，连原生菜单栏和状态栏都会异常。
真正容易被忽略的是：这个设置可能来自汉化包、旧备份迁移，或某次“优化性能”时的手动清理——它不会在插件管理界面体现，只能靠人工排查。
