context.sublime-menu 文件必须严格放在 packages/user/ 目录下才生效，侧边栏右键菜单则需另存为 packages/context.sublime-menu；文件名、编码、json 格式及 command 值均须准确，否则静默失效。
Context.sublime-menu 文件必须放在 Packages/User/ 目录下才生效
Sublime Text 只加载 Packages/User/Context.sublime-menu 这一个路径的文件，其他位置全无效。放错路径（比如丢进 Packages/Default/、Packages/SideBarEnhancements/ 或随便新建的文件夹）会导致右键菜单静默失效——没变化、控制台不报错、也没任何提示。
操作路径必须严格对应系统：
- 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
确认方式：菜单栏 → Preferences → Browse Packages… → 进入弹出的 User 文件夹 → 直接在此处新建或编辑文件。
常见错误包括：
- 文件名写成
context.sublime-menu（小写开头）或Context Menu.sublime-menu（含空格） - 保存为
.txt后缀（如Context.sublime-menu.txt） - 编码不是 UTF-8（尤其含中文
caption时，带 BOM 或 GBK 会直接导致整个菜单不加载）
JSON 格式必须合法，且 command 值要与命令面板完全一致
Context.sublime-menu 是一个 JSON 数组，语法稍有偏差（比如少逗号、引号错位、多括号）就会静默失败。它不会报错，只是整个文件被跳过。
基础结构示例（可直接复制使用）：
[{"caption": "排序行", "command": "sort_lines"}, {"caption": "-"}, {"caption": "复制文件路径", "command": "copy_path"}]
关键点：
-
caption支持中文，但必须用英文双引号包裹 -
command必须和命令面板中显示的 ID 完全一致：大小写敏感、无空格、无Command后缀（例如MyCustomCommand类对应"command": "my_custom"） - 内置命令如
sort_lines、toggle_comment开箱即用；插件命令如copy_path、open_in_terminal需先安装对应插件（CopyFilePath、Terminal），并确认未被禁用 - 验证命令是否存在：按
Ctrl+Shift+P（Win/Linux）或Cmd+Shift+P（macOS），输入关键词搜索，看到才说明可用
侧边栏右键菜单需用 Packages/Context.sublime-menu（注意：无 /User/）
这是最容易混淆的一点：编辑区右键和侧边栏右键由**两个不同路径的文件**控制。
侧边栏（点击文件/文件夹节点时）只读取 Packages/Context.sublime-menu（注意路径中没有 /User/）。这个文件若不存在，Sublime 不会自动创建，必须手动新建。
常见需求示例（侧边栏添加终端打开）：
[{"caption": "Open in Terminal", "command": "open_in_terminal", "args": {"path": "$file_path"}}, {"caption": "-", "id": "sep1"}, {"caption": "Reveal in Finder", "command": "reveal_in_finder", "args": {"file": "$file"}}]
注意事项：
-
$file_path、$file等变量必须写在args对象里，且不能加引号（写成"$file_path"就是字面字符串，不是变量替换） - SideBarEnhancements 插件的命令（如
side_bar_new_file）只对「已通过 Project → Add Folder to Project… 显式添加」的目录生效，拖拽打开或 File → Open Folder 不算 - 路径含中文、空格或括号（如
my project (v2)）可能导致open_in_terminal失败，建议先用纯英文路径测试
context 字段决定菜单项在哪出现，不加就到处弹
没有 context 的菜单项会在编辑区、侧边栏、标签页右键全部显示，极易干扰。实际使用中必须过滤。
常用 context 条件组合：
- 只在侧边栏文件夹节点上显示：
"context": [{"key": "node_type", "operand": "folder"}] - 只在侧边栏文件节点上显示：
"context": [{"key": "node_type", "operand": "file"}] - 只在编辑区有选中文本时显示：
"context": [{"key": "selection_empty", "operator": "equal", "operand": false}] - 只在 Python 文件中显示：
"context": [{"key": "selector", "operand": "source.python"}]（仅适用于编辑区，侧边栏节点无selector属性）
多个条件并列即“且”关系，例如限制为“侧边栏文件夹 + 非空白点击”：
"context": [{"key": "node_type", "operand": "folder"}, {"key": "selection_empty", "operator": "equal", "operand": false}]
别指望靠文件名或目录名做判断——Sublime 的 context 不支持路径匹配，硬写 file_name 或 file_path 条件无效。
