sublime text 保存时自动去除 bom 需配置 "save_with_bom": false 和 "default_encoding": "utf-8",修改用户级 preferences.sublime-settings 文件,再对已带 bom 文件执行 convert to utf-8 后保存。

Sublime Text 保存时自动去除 BOM 的配置位置
Sublime Text 默认不会自动清除 BOM,必须手动修改 Preferences.sublime-settings 文件。这个文件在不同系统路径不同,但本质是用户级设置,优先级高于默认设置:
- macOS:
~/Library/Application Support/Sublime Text/Packages/User/Preferences.sublime-settings - Windows:
%APPDATA%\Sublime Text\Packages\User\Preferences.sublime-settings - Linux:
~/.config/sublime-text/Packages/User/Preferences.sublime-settings
别改错文件——改 Default/Preferences.sublime-settings 没用,它会被用户配置覆盖,且重启后可能重置。
关键配置项:ensure_ascii 不管用,真正起作用的是 default_encoding 和 save_with_bom
很多人误以为设 ensure_ascii 或改 encoding 就能去 BOM,其实 Sublime 的 BOM 行为由两个独立开关控制:
-
"save_with_bom": false—— 这是核心开关,设为false后,**新保存的 UTF-8 文件绝不会带 BOM**(无论是否已存在 BOM) -
"default_encoding": "UTF-8"—— 必须显式指定,否则某些旧版 Sublime 在无编码声明时可能 fallback 到UTF-8 with BOM
注意:save_with_bom 对已带 BOM 的文件「另存为」无效,只影响「保存」动作本身;BOM 是否被读取,还取决于当前文件的编码识别状态。
打开带 BOM 的文件后,为什么保存仍可能残留?
这是最常踩的坑:即使设置了 "save_with_bom": false,如果文件原本就有 BOM,Sublime 会沿用其原始编码(显示为 UTF-8 with BOM),此时「保存」只是原样写回,BOM 不会自动剥离。
- 解决方法:打开文件后,先点击右下角编码名称(如
UTF-8 with BOM)→ 选Convert to UTF-8→ 再按Ctrl+S(Win/Linux)或Cmd+S(macOS) - 不推荐用
Save with Encoding → UTF-8,它可能在部分版本中悄悄加回 BOM - 批量处理可用插件
Remove BOM,但纯配置方案更轻量、无依赖
跨平台兼容性要点:别信「UTF-8」字样,认准实际字节流
Windows 记事本、PowerShell、.NET 程序对 BOM 敏感;Linux/macOS shell 工具(如 grep、sed)和 Python 解释器通常忽略它,但 Node.js 的 require()、Webpack 构建等场景可能报 Unexpected token 错误。
- 验证是否真去除了 BOM:用
xxd或hexdump -C查看文件头,UTF-8 无 BOM 应以ef bb bf开头(有 BOM)或直接是文本字节(无 BOM) - CI/CD 流水线里,别只靠编辑器配置,建议在脚本中加检查:
head -c 3 file.js | xxd,避免团队协作时有人忘了转换
BOM 是个隐形字符,看不见摸不着,但一旦混进 JSON、JS 或 Shell 脚本开头,错误信息往往指向第一行语法,而不是源头的三个字节。










