Sublime Text 中通过状态栏编码显示识别BOM:若显示“UTF-8 with BOM”等即含BOM;可用“Save with Encoding → UTF-8”移除,或“Reopen with Encoding → UTF-8 with BOM”后“Convert to UTF-8”再保存批量处理;需检查Settings和.editorconfig避免自动写入BOM。

Sublime Text 里怎么识别文件是否带 BOM
打开文件后,左下角状态栏会显示编码格式,如果看到 UTF-8 with BOM 或 UTF-16 LE/BE with BOM,就说明当前文件含有 BOM。BOM 是开头的不可见字节(如 EF BB BF),虽不影响人眼阅读,但 PHP、Python 等脚本语言解析时可能报 Unexpected token 或 Non-UTF-8 code starting with 0xef 这类错误。
用 Save with Encoding → UTF-8 移除 BOM
这是最直接、无需插件的方法:
- 点击菜单栏
File → Save with Encoding → UTF-8 - 注意:不是
UTF-8 with BOM,也不是默认保存(它会保留原编码) - 保存后,状态栏应变为
UTF-8(无 “with BOM” 字样) - 再次打开该文件,BOM 不会自动恢复 —— Sublime 默认按文件实际内容判断编码,不会凭空加 BOM
批量处理多个文件:用 Convert to UTF-8 再保存
如果要处理一个项目里几十个 PHP/JS 文件,手动一个个点太慢。可配合 Convert to UTF-8 命令预清洗:
- 打开文件 →
File → Reopen with Encoding → UTF-8 with BOM(强制按带 BOM 解码) - 再执行
File → Convert to UTF-8(这步把内容转为纯 UTF-8 内存表示,BOM 被剥离) - 最后
File → Save,此时保存的是无 BOM 的 UTF-8 - ⚠️ 注意:
Convert to UTF-8不会改变状态栏显示,必须手动保存才生效
避免下次再写入 BOM:关掉自动添加选项
Sublime 默认不会主动加 BOM,但某些插件(比如 EditorConfig 或旧版 HTML-CSS-JS Prettify)可能在保存时注入。检查以下位置:
- 打开
Preferences → Settings – User - 确认没有这一行:
"default_encoding": "UTF-8 with BOM" - 如有,删掉;或显式加上:
"fallback_encoding": "UTF-8" - 更稳妥的做法:在项目根目录加
.editorconfig,写入charset = utf-8(不带 BOM)
root = true [*] charset = utf-8 end_of_line = lf insert_final_newline = true
BOM 是个静默问题,改完不一定立刻报错,但上线后 PHP header() 失效、JSON parse error 都可能源于它。每次新建文件别依赖“默认保存”,养成先看状态栏编码的习惯。










