Sublime Text 右键菜单需手动编辑用户目录下的 Context.sublime-menu 文件，格式为 JSON，每项含 caption 和 command；错误路径、格式或无效命令名将导致菜单不显示且无报错。
Sublime Text 的右键菜单（Context Menu）不能通过图形界面直接添加自定义项，必须手动编辑 Context.sublime-menu 文件。改错位置或格式错误会导致菜单项不显示，且 Sublime 不报错——这是最常被卡住的地方。
找到正确的 Context.sublime-menu 文件路径
不同操作系统、不同安装方式（便携版 / 系统安装 / 多版本共存）下，配置文件的生效位置不同。优先修改用户目录下的文件，避免被升级覆盖：
- Windows：
%APPDATA%\Sublime Text\Packages\User\Context.sublime-menu -
macOS：
~/Library/Application Support/Sublime Text/Packages/User/Context.sublime-menu - Linux：
~/.config/sublime-text/Packages/User/Context.sublime-menu
⚠️ 注意：不要修改 Packages/Default/Context.sublime-menu —— 这是只读内置文件，修改无效；也不要放在其他 Package 目录下（比如 Package Name/），除非你明确在做插件开发。
添加一个能执行命令的右键菜单项
每个菜单项是一个 JSON 对象，必须包含 caption（显示文字）和 command（要执行的命令名）。如果命令需要参数，用 args 字段传入。
例如：添加「复制当前文件路径」到右键菜单：
[
{
"caption": "复制文件路径",
"command": "copy_path"
}
]
这个例子依赖插件 CopyFilePath（需先安装）。若想调用原生命令，比如「在终端中打开当前文件夹」，可写：
[
{
"caption": "-",
"command": "dummy"
},
{
"caption": "在终端中打开",
"command": "open_terminal_project_folder"
}
]
⚠️ 注意：open_terminal_project_folder 是 Terminal 插件提供的命令，不是 Sublime 内置命令；没有安装对应插件时，点击菜单会静默失败，无提示。
菜单分组、分割线与作用域控制
右键菜单支持按上下文动态显示。比如只想在编辑器区域右键时出现某选项，不在侧边栏出现，就加 context 字段：
[
{
"caption": "仅在编辑区显示",
"command": "toggle_comment",
"context": [
{ "key": "selector", "operator": "equal", "operand": "text" }
]
}
]
常见易错点：
-
"-"表示分割线，必须单独成对象，且command字段不能省略（可用"command": "dummy"占位） - 多个菜单项合并进一个数组，不要套多层
[] - JSON 语法必须严格：末尾不能有逗号，字符串必须双引号，布尔值小写（
true/false） - 修改后保存即生效，无需重启 Sublime，但菜单不会自动刷新——需右键一次空白处触发重载
真正麻烦的不是写法，而是命令名是否真实存在、是否在当前上下文可用、参数类型是否匹配。建议先在 Ctrl+Shift+P（命令面板）里搜到目标命令，再查它的文档或源码确认 args 结构；盲目照抄网上旧教程里的命令名，大概率失效。
