Atom汉化后菜单/设置显示方块□,说明插件已生效但缺少中文字体;Linux需安装WenQuanYi Zen Hei并配置Font Family,Windows需确保微软雅黑等字体存在,且必须全开汉化菜单、右键菜单、汉化设置三项开关。

Atom汉化后菜单/设置显示方块□,不是插件没生效
界面出现“□□□”或文字缺失,说明atom-simplified-chinese-menu插件已正确加载(否则仍是英文),但系统缺少能渲染中文的字体。Linux/macOS 默认字体族不含中文字形,Windows 虽有 SimSun,但 Atom 可能未主动 fallback 到它。
- Linux:运行
fc-list :lang=zh确认已安装WenQuanYi Zen Hei或WenQuanYi Micro Hei;若无,用包管理器安装(如 Ubuntu:sudo apt install fonts-wqy-zenhei) - Windows:打开控制面板 → 字体,搜索“微软雅黑”“SimSun”或“文泉驿”,至少确保一个存在
- Atom 设置 → Editor →
fontFamily填入:"DejaVu Sans, WenQuanYi Zen Hei, Microsoft YaHei, sans-serif"(顺序即 fallback 优先级) - UI 全局字体需额外配置:Edit → Stylesheet,添加:
html, body, .tree-view, .tab-bar .tab { font-family: "WenQuanYi Zen Hei", sans-serif; }
右下角状态栏显示中文但菜单仍是英文?检查三个开关是否全开
atom-simplified-chinese-menu 的汉化是分区域独立控制的,缺一不可。重启 Atom 后,进 Settings → Packages → Simplified Chinese Menu → Settings,确认以下三项全部勾选:
-
汉化菜单:控制顶部文件、编辑、视图等主菜单栏 -
汉化右键菜单:影响项目树、编辑区任意位置弹出的上下文菜单 -
汉化设置:让 Settings 面板本身(包括左侧导航、配置项说明)也转为中文
很多人只开了前两项,进 Settings 时突然看到英文,误以为插件失效——其实只是第三项没开。
config.cson里写core.language: "zh-CN"导致启动报错
Atom 官方根本不识别 core.language 这个配置项。你在 ~/.atom/config.cson 里手动加这行:
core: language: "zh-CN"
会导致 Atom 启动时报错:Unknown config key 'core.language'。这不是警告,是明确拒绝加载该字段,既不生效,还可能干扰其他插件读取配置。
真正起作用的只有 atom-simplified-chinese-menu 插件本身,它不依赖任何 config.cson 语言配置。删掉所有类似字段,重启即可。
汉化后终端/脚本输出仍乱码,和界面无关
Atom 编辑器 UI 汉化成功 ≠ 运行环境支持中文输出。如果你用 script 插件跑 Python、或在内置终端执行命令,中文乱码来自执行进程,不是 Atom 界面问题:
- Python:系统级设置
PYTHONIOENCODING=utf-8(Windows 加系统环境变量;macOS/Linux 在 shell 配置里加export PYTHONIOENCODING=utf-8) - Windows 终端默认编码是 GBK,运行
chcp 65001切到 UTF-8;更彻底的方案是注册表修改:HKEY_LOCAL_MACHINE\Software\Microsoft\Command Processor\Autorun设为@chcp 65001>nul - HTML 预览乱码:确保文件开头有
,且文件本身保存为 UTF-8 without BOM
界面字体配好了、三个开关全开了、config.cson 里没瞎写 language 字段——这些做完,如果还有乱码,基本可以确定是运行时环境或文件编码本身的问题,跟汉化无关。











