atom 中文化需安装 language-pack-zh-cn 并在设置中手动设 locale 为 zh-cn(小写带短横),系统语言无效;还需确保中文字体可用,避免插件冲突。

为什么直接改 locale 或系统语言没用
Atom 不读取系统 LANG 或 Windows 区域设置;它只认自己配置的 core.locale 设置项。即使你把 macOS/Windows 语言设为中文,Atom 启动后仍是英文——这是常见误解的根源。
安装并启用 language-pack-zh-cn
Atom 官方推荐的中文语言包是 language-pack-zh-cn,由社区持续维护(注意不是已废弃的 atom-language-chinese):
- 打开 Atom → Atom → Preferences(macOS)或 Edit → Preferences(Windows/Linux)
- 左侧点 Install,搜索框输入
language-pack-zh-cn - 点击安装,完成后重启 Atom
- 重启后进入 Settings → Core,找到
Locale选项,手动输入zh-CN(必须小写、带短横线)
如果输入 zh、chinese 或留空,界面不会变中文——这是最常踩的坑。
安装后仍显示英文?检查字体与 fallback
中文化失败的第二大原因是字体缺失:Atom 渲染中文 UI 时会尝试调用系统中文字体(如 macOS 的 PingFang SC、Windows 的 Microsoft YaHei)。若字体名被改写、路径异常或权限受限,部分按钮/菜单可能回退为方块或英文。
- 确认系统已安装基础中文字体(Windows 一般自带,macOS 12+ 默认有,Linux 需装
fonts-wqy-zenhei等) - 在 Atom 设置页搜索
font family,将Editor Font Family改为含中文支持的字体,例如"PingFang SC", "Microsoft YaHei", "sans-serif" - 不建议只写
"SimSun"或"Noto Sans CJK SC"——某些旧版本 Atom 对空格和引号解析不稳定
插件冲突会导致 locale 失效
少数插件(尤其是早期主题类插件如 seti-ui、one-dark-ui 的旧版)会硬编码英文字符串,覆盖语言包翻译。若发现只有菜单栏变中文、而右键菜单/命令面板仍是英文,大概率是这类插件未适配最新 language-pack-zh-cn API。
- 临时禁用所有 UI 相关插件,仅保留
language-pack-zh-cn,验证是否恢复 - 逐个启用,定位冲突插件;替代方案是换用已明确声明支持 i18n 的主题,如
atom-material-ui - 特别注意:修改
~/.atom/config.cson手动加core: { locale: "zh-CN" }无效——该字段已被弃用,仅前端 Settings 页面生效
真正起作用的 locale 设置只存在于 Atom 运行时内存中,不写入 config.cson,也不继承自环境变量。这点和多数 Electron 应用不同,容易误判。











