Atom中Default Encoding必须填小写utf8(非UTF-8或utf-8),仅影响新建及无BOM文件;修复乱码需先Reopen with Encoding选对编码,再Save with Encoding转UTF-8,CSON配置文件须存为UTF-8无BOM。

Settings → Core 里 default encoding 必须填 utf8(小写,无短横)
Atom 的图形界面设置中,Default Encoding 是个下拉菜单,但它的可选项里没有 “UTF-8” 或 “utf-8”,只有 utf8 这一项。填错就无效——比如输成 UTF-8、utf-8 或留空,都会回退到系统 locale 编码(Windows 中文版默认是 GBK)。这个设置只影响新建文件和未带 BOM/未指定编码的粘贴内容,对已存在的文件完全不生效。
已有乱码文件不能靠改默认编码修复,必须手动 Reopen with Encoding
打开一个 GBK 编码的 .txt,右下角显示 UTF-8 并乱码?这不是 Atom 记错了,而是它真正在用 UTF-8 解码那堆 GBK 字节。此时改全局 default encoding 毫无作用。正确做法是:
- 点击右下角当前编码标识 →
Reopen with Encoding→ 逐个试GBK、GB18030,直到中文正常显示 - 确认显示正确后,再点同一位置 →
Save with Encoding→ 选UTF-8保存 - 关闭并重新打开,验证是否仍正常 —— 这步不执行,下次打开还是乱码
config.cson 顶层加 defaultEncoding: "utf8" 更可靠
图形界面设置可能被插件覆盖或延迟刷新,尤其在多用户或自动化部署时。直接编辑配置文件能绕过这些干扰:
- 打开
Atom → Config…,进入config.cson - 在文件最顶部(无缩进、不嵌套)、其他 block 外,添加一行:
defaultEncoding: "utf8" - 保存后立即生效,无需重启 Atom
- 注意:不是 JSON 格式,不要加
{}或逗号;缩进错误会导致整行被忽略
强制保存为 UTF-8 需配合 convertOnSave 或手动操作
即使 defaultEncoding 设为 utf8,Atom 保存时仍按当前文件“已加载的编码”写入。一个用 GBK 打开的旧文件,Ctrl+S 仍是 GBK。要真正转码:
- 临时方案:每次保存前右键 →
Save with Encoding→UTF-8 - 长期方案:装
auto-encoding插件,在其设置里填defaultEncoding: "utf8"并开启convertOnSave - ⚠️ 警告:
convertOnSave会真实重写文件字节,若原文件含 GBK 特有字符(如某些生僻汉字),转成 UTF-8 后可能丢失;务必先备份关键配置文件(如snippets.cson)
keymap.cson、snippets.cson)必须存为 UTF-8 无 BOM,否则 Atom 解析失败,连快捷键都失效 —— 这类文件一旦用 Windows 记事本编辑过,几乎必中招。

















