Sublime Text右键菜单汉化教程：修改语言包JSON文件实现中文界面
右键菜单汉化原理：修改语言包而非系统设置
许多用户误以为需要调整系统区域或注册表，实际上Sublime Text的右键菜单文字完全由内置语言包文件控制。核心文件包括Default.sublime-menu和Side Bar.sublime-menu，汉化的本质就是修改这些JSON文件中的"caption"字段值。
关键注意事项：直接修改安装目录下的原始文件可能导致升级覆盖。推荐采用「覆盖目录」方案实现持久化汉化，具体操作步骤如下：
- 通过
Preferences → Browse Packages…进入用户包目录 - 新建
Default文件夹（如不存在） - 在
Default文件夹内创建Side Bar.sublime-menu和Context.sublime-menu文件 - 从
Packages/Default.sublime-package压缩包提取原始内容，复制到新建文件中 - 逐条翻译
"caption"字段，例如将"caption": "Open File"改为"caption": "打开文件"
⚠️ 重要原则：仅修改"caption"和"caption_en"字段，保持"command"、"args"等功能字段不变。中文内容需用英文双引号包裹，避免JSON解析失败导致菜单消失。
自定义右键菜单项：正确配置context条件确保显示
添加自定义右键菜单项时，"context"条件配置决定菜单是否显示。以“在终端打开当前文件夹”功能为例，需确保条件匹配侧边栏文件夹场景：
错误配置示例：
{
"caption": "在终端打开",
"command": "open_terminal_project_folder",
"context": [
{ "key": "selector", "operator": "equal", "operand": "text" },
{ "key": "setting.sidebar_visible", "operator": "equal", "operand": true }
]
}
正确配置应包含以下关键条件：
{ "key": "side_bar", "operator": "equal", "operand": true }（限定侧边栏区域）{ "key": "selection_empty", "operator": "equal", "operand": true }（确保无文本选中）{ "key": "is_folder", "operator": "equal", "operand": true }（仅对文件夹生效）
自定义菜单不显示的常见原因包括：缺少"side_bar"判断、误用编辑区专用的"selector"条件、或将布尔值true错误写为字符串"true"。
内置命令汉化方案：通过命令重映射实现中文显示
open_in_browser（在浏览器中打开）、copy_path（复制路径）等内置命令的菜单文字存储在核心语言包中，直接修改Side Bar.sublime-menu可能无效。推荐采用命令重映射策略：
- 在
Packages/User/目录创建Default.sublime-commands文件 - 添加中文命令定义，例如：
[
{
"caption": "在浏览器中打开",
"command": "open_in_browser"
}
]
随后在自定义的Side Bar.sublime-menu文件中引用新定义的"caption"。此方法可避免Sublime优先加载原生英文菜单项，确保中文显示生效。
中文菜单项无响应排查：命令验证与插件依赖检查
菜单项点击无响应通常源于命令本身问题，而非翻译错误。常见原因包括：
- 命令依赖未安装插件：如
open_terminal_project_folder需要Terminus或ShellCommand插件支持 - 命令已过时：Sublime 4中
expand_selection_to_paragraph已被expand_selection_to_block替代 - 命令需额外配置：
build_with命令要求预先配置.sublime-build文件，否则报错No build system found
快速验证方法：按Ctrl+Shift+P打开命令面板，输入菜单项使用的命令名。若无法搜索或执行，表明命令不存在、拼写错误或执行条件不满足。
成功汉化Sublime右键菜单的关键在于确保每个中文项对应的命令真实可用、上下文条件精确匹配、参数完全兼容。建议修改后重启Sublime，并在编辑区、侧边栏、空白区域等多场景测试，保证汉化效果稳定可靠。
