Sublime Text 右键菜单可通过编辑 User/Context.sublime-menu 文件自定义，需按系统路径手动创建 UTF-8 编码的 JSON 格式文件，利用 context 字段精准控制命令在文本区、侧边栏等不同位置的显示条件。
Sublime Text 的右键菜单（上下文菜单）可以通过编辑 Context.sublime-menu 文件来自定义，添加常用命令（比如格式化、复制路径、运行脚本等）。这个文件控制的是在编辑器内**文本区域、侧边栏、标签页等不同位置**点击右键时显示的选项。
找到并创建 Context.sublime-menu 文件
Sublime 默认没有提供该文件，需要手动创建。路径取决于你的系统和 Sublime 版本（以 Sublime Text 4 为例）：
-
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
如果 User 文件夹下没有 Context.sublime-menu，就新建一个纯文本文件，保存为该名字，编码选 UTF-8，确保后缀是 .sublime-menu（不是 .txt）。
理解菜单结构和作用域
这个文件是 JSON 格式数组，每一项是一个菜单项对象。关键字段有：
-
caption：菜单上显示的文字（支持 & 快捷键，如
"&Format"显示为 Format） -
command：要执行的命令名（比如
"toggle_comment"、"reindent"） - args：传递给命令的参数（可选）
- context：控制该菜单项在哪种场景下出现（非常重要！）
context 是个数组，每个元素含 key 和 operator（如 "equal"）、operand（值），常见判断条件：
-
{"key": "selector", "operator": "equal", "operand": "source.python"}→ 只在 Python 文件中显示 -
{"key": "selection_empty", "operator": "equal", "operand": true}→ 无选中文本时才显示 -
{"key": "side_bar", "operator": "equal", "operand": true}→ 右键点在侧边栏时生效 -
{"key": "file_name", "operator": "regex_contains", "operand": "\\.py$"}→ 文件名匹配正则时显示
添加几个实用命令示例
以下是一个精简但常用的 Context.sublime-menu 示例内容（可直接复制使用）：
[
{ "caption": "-",
"command": "dummy" },
{ "caption": "Format Code",
"command": "reindent",
"args": {"single_line": false},
"context": [
{"key": "selector", "operator": "not_equal", "operand": "source"},
{"key": "selection_empty", "operator": "equal", "operand": true}
]
},
{ "caption": "Toggle Comment",
"command": "toggle_comment",
"args": {"block": false}
},
{ "caption": "Copy File Path",
"command": "copy_path"
},
{ "caption": "Open Containing Folder",
"command": "open_dir",
"args": {"dir": "$file_path"},
"context": [{"key": "file_name", "operator": "not_equal", "operand": ""}]
}
]
说明：
-
"-"是分隔线（用dummy命令占位） -
reindent在非 source 模式且无选中时格式化全文（避免误触） -
copy_path和open_dir需要当前有打开的文件（靠file_name判断） - 所有命令名必须拼写正确，可通过 Command Palette → “Developer: Show All Commands” 查看支持的命令列表
调试与生效技巧
改完保存后，右键菜单不会自动刷新。可以：
- 重启 Sublime Text（最稳妥）
- 或按
Ctrl+Shift+P（Win/Linux） /Cmd+Shift+P（macOS），输入 “Satisfy Dependencies” 并回车（部分插件触发重载） - 如果菜单不出现，打开 Console（View → Show Console），看是否有 JSON 解析错误（比如逗号多写、引号不匹配）
- 想快速测试 context 是否生效？先加一条简单项，比如只带
"caption": "TEST"和"command": "echo"（需自定义 echo 命令），再逐步加条件
基本上就这些。不需要插件，纯配置就能让右键更顺手。关键是理解 context 规则——不然命令可能一直不显示，或者到处乱冒。
