sublime怎么设置自定义右键菜单项_sublime修改Context菜单配置文件【教程】

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 结构；盲目照抄网上旧教程里的命令名，大概率失效。