Sublime Text去除BOM头_插件与设置方法
BOM（Byte Order Mark，字节顺序标记）是UTF-8编码文件开头的三个不可见字符（EF BB BF），用于标识文件编码和字节顺序。很多编辑器在保存UTF-8文件时会自动添加BOM头，这在纯文本文件中没问题，但在PHP、ASP等服务端脚本中会导致严重问题——页面顶部出现空白、验证码不显示、session和cookie设置失败、headers already sent错误、JSON和XML解析失败等。本文讲解BOM头的原理、对网页的影响、检测方法、各种编辑器和脚本的去除方法，以及批量清理网站程序中BOM头的实用技巧。
VSCode去除BOM头。打开文件后，点击右下角状态栏的编码显示（如「UTF-8 with BOM」），在弹出菜单中选择「Save with Encoding」（通过编码保存），然后选择「UTF-8」（不带BOM的选项），保存后BOM头去除。设置默认保存为无BOM：点击「文件」-「首选项」-「设置」，搜索「files.encoding」，设置为utf8；搜索「files.showByteOrderMark」，设置为false（不显示BOM标记，即默认不添加BOM）。VSCode默认新建UTF-8文件是不带BOM的，但打开带BOM的文件保存时会保留BOM，需要手动转为无BOM。
Sublime Text去除BOM头。Sublime Text默认保存UTF-8不带BOM。如果文件有BOM头，点击「File」-「Save with Encoding」-「UTF-8」，保存后去除BOM。注意不要选「UTF-8 with BOM」。安装「EncodingHelper」插件可以在状态栏显示文件编码和BOM状态，方便检测。设置默认编码：「Preferences」-「Settings」，添加"default_encoding": "UTF-8"，"show_encoding": true。Dreamweaver去除BOM头：「修改」-「页面属性」-「标题/编码」，编码选择Unicode (UTF-8)，不勾选「包括Unicode签名(BOM)」，确定后保存页面。旧版Dreamweaver默认保存UTF-8时会添加BOM，需要手动取消勾选。
检测文件是否有BOM头的方法。方法一：用十六进制编辑器打开文件，查看开头三个字节是否是EF BB BF。Notepad++的「插件」-「HEX-Editor」-「View in HEX」可以查看十六进制。方法二：用PHP脚本检测，代码：<?php $file = 'test.php'; $f = fopen($file, 'r'); $bom = fread($f, 3); fclose($f); if ($bom == pack('CCC', 0xEF, 0xBB, 0xBF)) { echo '有BOM头'; } else { echo '无BOM头'; }。方法三：Linux命令检测：head -c 3 file.php | xxd，输出开头是efbbbf说明有BOM头。方法四：用编辑器查看编码，Notepad++底部状态栏显示「UTF-8-BOM」说明有BOM头，显示「UTF-8」说明无BOM头。
Linux命令批量去除BOM头（适合有SSH权限的用户）。方法一：find命令配合sed，扫描当前目录及子目录下所有PHP文件，去除开头三个字节：find . -type f -name "*.php" -exec sed -i '1s/^xefxbbxbf//' {} ;。把*.php改为*.html、*.css、*.js等处理其他类型。方法二：用find配合vim：find . -type f ( -name "*.php" -o -name "*.html" -o -name "*.js" -o -name "*.css" ) -exec vim -c "set nobomb" -c "wq" {} ;。方法三：用dos2unix工具（部分系统自带）：dos2unix *.php。dos2unix会同时转换换行符和去除BOM。执行前先备份文件，批量操作有风险。
PowerShell批量去除BOM头（Windows环境）。代码：$path = "." $files = Get-ChildItem -Path $path -Recurse -Include *.php,*.html,*.css,*.js,*.txt $count = 0 foreach ($file in $files) { $bytes = [System.IO.File]::ReadAllBytes($file.FullName) if ($bytes.Length -ge 3 -and $bytes[0] -eq 0xEF -and $bytes[1] -eq 0xBB -and $bytes[2] -eq 0xBF) { $newBytes = $bytes[3..($bytes.Length-1)] [System.IO.File]::WriteAllBytes($file.FullName, $newBytes) Write-Host "已去除: $($file.FullName)" $count++ } } Write-Host "完成，共处理$count个文件"。保存为remove_bom.ps1，右键「使用PowerShell运行」，或在PowerShell中执行。如果提示执行策略限制，先运行Set-ExecutionPolicy RemoteSigned。
Python脚本批量去除BOM头（适合本地开发环境）。代码：# -*- coding: utf-8 -*- import os def remove_bom(path): count = 0 for root, dirs, files in os.walk(path): for f in files: if f.lower().endswith(('.php', '.html', '.htm', '.css', '.js', '.txt', '.xml', '.json')): filepath = os.path.join(root, f) with open(filepath, 'rb') as fp: data = fp.read() if data[:3] == b'xefxbbxbf': with open(filepath, 'wb') as fp: fp.write(data[3:]) print(f'已去除: {filepath}') count += 1 print(f'完成，共处理{count}个文件') if __name__ == '__main__': remove_bom('.')。保存为remove_bom.py，在网站目录下运行python remove_bom.py。Python3环境下运行，处理前备份文件。
BOM头导致验证码不显示的原理。验证码图片通过PHP的GD库生成，用header('Content-Type: image/png')设置内容类型，然后输出图片二进制数据。如果PHP文件有BOM头，BOM头会在图片数据之前输出，导致浏览器接收到的数据是「BOM头 + 图片数据」，不是合法的PNG格式，浏览器无法解析，显示为叉号或空白。解决方法是去除生成验证码的PHP文件（以及include的所有文件）的BOM头。注意不仅验证码文件本身不能有BOM头，它include/require的所有文件（如数据库配置文件、函数库文件）也不能有BOM头，任何一个文件有BOM头都会导致输出异常。
BOM头导致的其他问题。CSS文件有BOM头时，部分浏览器会忽略CSS的第一行规则（因为BOM头在@charset或第一条规则之前），导致第一条样式失效。JS文件有BOM头时，某些旧浏览器会解析报错，因为BOM头在JS代码之前被当作非法字符。JSON接口返回的数据有BOM头时，前端的JSON.parse()会抛出「Unexpected token」错误，因为JSON数据开头多了三个字节。XML文件有BOM头时，XML解析器可能报错「XML declaration not at start of document」，因为XML声明<?xml之前有BOM头。下载文件的PHP脚本有BOM头时，下载的文件开头多了三个字节，导致文件损坏（如ZIP无法解压、图片无法打开）。
BOM头的原理。UTF-8编码的BOM头是三个字节：EF BB BF，位于文件最开头。UTF-16和UTF-32编码的BOM头是FE FF或FF FE，用于标识字节顺序（大端或小端）。UTF-8编码本身不需要BOM头来标识字节顺序（因为UTF-8的字节顺序是固定的），BOM头在UTF-8中仅用于标识这是一个UTF-8文件。很多Windows编辑器（如旧版记事本）在保存UTF-8时自动添加BOM头，因为Windows系统通过BOM头区分UTF-8和系统默认编码（如GBK）。但在Linux和Web开发中，UTF-8文件不应该带BOM头。
开发者真实体验：「session_start()一直报headers already sent，报错行号是1，看了文章才知道是BOM头，把config.php转为无BOM后解决了」「团队里有人用旧版记事本保存文件自动加BOM，导致线上出问题，现在统一要求用VSCode默认UTF-8无BOM，提交前用脚本检查，再也没出过BOM头问题」。
操作提示：遇到页面顶部空白、验证码不显示、session/cookie失败、JSON解析失败，先检查报错行号，如果是行号1基本就是BOM头。单个文件用编辑器「转为UTF-8无BOM」处理，注意选「转为」不是「使用」。整个网站用批量脚本处理（PHP脚本适合虚拟主机，Python/PowerShell适合本地，find/sed适合Linux服务器）。处理前务必备份文件，批量操作有风险。处理后清除浏览器缓存和OPcache，重新测试。
更新时间：2026-09-01 14:21:00