Sublime如何设置保存时自动清除BOM头?(跨平台兼容)

2次阅读

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

Sublime如何设置保存时自动清除BOM头?(跨平台兼容)

sublime text 保存时自动去除 BOM 的配置位置

Sublime Text 默认不会自动清除 BOM,必须手动修改 Preferences.sublime-settings 文件。这个文件在不同系统路径不同,但本质是用户级设置,优先级高于默认设置:

  • macos~/Library/Application Support/Sublime Text/Packages/User/Preferences.sublime-settings
  • windows%APPDATA%Sublime TextPackagesUserPreferences.sublime-settings
  • linux~/.config/sublime-text/Packages/User/Preferences.sublime-settings

别改错文件——改 Default/Preferences.sublime-settings 没用,它会被用户配置覆盖,且重启后可能重置。

关键配置项:ensure_ascii 不管用,真正起作用的是 default_encodingsave_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 工具(如 grepsed)和 Python 解释器通常忽略它,但 Node.jsrequire()webpack 构建等场景可能报 Unexpected Token 错误。

  • 验证是否真去除了 BOM:用 xxdhexdump -C 查看文件头,UTF-8 无 BOM 应以 ef bb bf 开头(有 BOM)或直接是文本字节(无 BOM)
  • CI/CD 流水线里,别只靠编辑器配置,建议在脚本中加检查:head -c 3 file.js | xxd,避免团队协作时有人忘了转换

BOM 是个隐形字符,看不见摸不着,但一旦混进 json、JS 或 Shell 脚本开头,错误信息往往指向第一行语法,而不是源头的三个字节。

text=ZqhQzanResources