sublime text 菜单汉化不生效，主因是 localizedmenu 插件未正确加载、ui_language 设置冲突、st4 兼容性问题或快捷键绑定依赖英文 caption；需检查路径、重启、验证加载、清理干扰设置、确保 utf-8 编码，并优先使用适配 st4 的魔改版。
Sublime Text 菜单汉化后不生效？检查 LocalizedMenu 是否加载成功
插件装了但菜单还是英文，大概率是没被 Sublime 正确识别。Sublime 不会自动启用下载的插件包，尤其是手动解压到 Packages/ 目录的第三方插件。
实操建议：
- 打开 Sublime → Preferences → Browse Packages…，确认
LocalizedMenu文件夹存在且路径为Packages/LocalizedMenu/（不是Packages/User/LocalizedMenu或嵌套子目录） - 重启 Sublime —— 这步不能跳，插件只在启动时扫描加载
- 按
Ctrl+Shift+P（Windows/Linux）或Cmd+Shift+P（macOS），输入Package Control: List Packages，看输出里是否有LocalizedMenu；没有就说明未加载 - 如果仍不显示，检查该文件夹内是否包含
Default.sublime-menu和zh-CN.lang（或类似命名的语言文件），缺一不可
菜单汉化失效但插件已加载？确认语言设置没被覆盖
Sublime 的界面语言优先级是：命令行参数 > Preferences.sublime-settings 中的 ui_language > 系统区域设置。很多人改了插件却忘了关掉高优先级的干扰项。
常见错误现象：
- 菜单一半中文一半英文（比如“File”变“文件”，但“Save As…”仍是英文）—— 说明部分菜单项没被
zh-CN.lang覆盖，或翻译文件有漏项 - 切换系统语言后汉化突然恢复 —— 印证是
ui_language写死导致冲突
实操建议：
- 打开 Preferences → Settings，检查右侧用户设置中是否含有
"ui_language": "en"或类似字段，删掉它 - 不要在命令行启动 Sublime 时加
--lang=en参数 - 确保
LocalizedMenu文件夹里的zh-CN.lang是 UTF-8 编码（无 BOM），否则 Sublime 会静默忽略整份翻译
Sublime 4 升级后汉化菜单消失？兼容性问题很常见
LocalizedMenu 是社区维护的老插件，原作者未适配 Sublime Text 4 的新菜单结构和 API 变动，很多 .sublime-menu 里的 key 已失效或重命名。
使用场景：
- 你用的是 Sublime Text 4.4169+（2023 年后版本），但插件最后更新停留在 2019 年
- 菜单项位置错乱、图标丢失、右键菜单未汉化 —— 都是典型兼容断层表现
实操建议：
- 别指望原版
LocalizedMenu在 ST4 上完整工作；可临时降级到 ST3（3211 版本最稳）验证是否为版本问题 - 若必须用 ST4，可尝试社区魔改版（如 GitHub 上搜
sublime-localizedmenu-st4），注意核对 commit 时间是否在 2023 年之后 - 手动补翻译？编辑
Default.sublime-menu时，需对照官方最新源码中的 menu key（例如"caption": "File"已改为"caption": "file"，大小写敏感）
汉化后快捷键失效或响应错位？菜单 caption 改动影响 command 绑定
很多人以为汉化只是改文字，其实 Sublime 的快捷键绑定（Default (Windows).sublime-keymap 等）依赖菜单项的 caption 值做匹配。一旦你把 "Save" 改成 "保存"，而 keymap 里还写着 "caption": "Save"，快捷键就找不到目标了。
性能 / 兼容性影响：
- 不会拖慢启动，但会导致部分快捷键静默失效，排查起来极隐蔽
- 某些插件（如
SideBarEnhancements）的右键菜单也依赖原始 caption，汉化后可能整个上下文菜单消失
实操建议：
- 不要直接修改
caption字段值；LocalizedMenu的机制是通过zh-CN.lang映射，保持.sublime-menu里仍是英文 caption - 检查你的自定义 keymap 文件，确认所有
"caption"字段仍为英文（如"caption": "Save"），而非中文 - 右键菜单异常？重点看
SideBarEnhancements或AdvancedNewFile等插件是否自带汉化逻辑，它们和LocalizedMenu容易打架
真正麻烦的从来不是装插件，而是菜单文本背后那一层隐式依赖：caption 字符串要对得上 keymap，lang 文件编码不能带 BOM，ST 版本一升级菜单结构就变，连空格多一个都可能导致整行翻译被跳过。
