Notepad++去除BOM头设置_编码转为UTF-8无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。
检测文件是否有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头。
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头的最佳实践。一是统一团队编辑器设置,所有开发者设置默认保存为UTF-8无BOM,在编辑器配置或团队规范中明确。二是代码提交前检查,Git可以配置pre-commit钩子检测BOM头,SVN可以用pre-commit脚本。三是网站程序上线前用批量脚本扫描一次,确保没有BOM头。四是从官方渠道下载程序,很多第三方修改版可能带BOM头。五是PHP项目中在入口文件开头用ob_start()开启输出缓冲,可以缓冲BOM头输出,避免header失败,但这只是临时方案,根本解决还是去除BOM头。六是模板文件(HTML、CSS、JS)也要检查,不只是PHP文件。
网站迁移后BOM头问题的处理。从Windows服务器迁移到Linux服务器,或从本地上传到虚拟主机,文件编码可能不一致,部分文件带BOM头。迁移后如果出现页面顶部空白、验证码不显示、登录异常,先检查文件编码。用批量PHP脚本扫描整个网站目录去除BOM头,然后清除缓存测试。迁移时建议用FTP的二进制模式传输文件,避免传输过程中编码被转换。Git/SVN版本控制的项目,在仓库中统一编码为UTF-8无BOM,检出时不会有BOM头问题。迁移后不仅检查PHP文件,还要检查HTML模板、CSS、JS、配置文件(.ini、.conf、.env),任何文本文件都可能带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。
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。执行前先备份文件,批量操作有风险。
运维评价:「BOM头是PHP开发中的经典坑,不可见但影响大,页面空白、验证码不显示、session失效、JSON解析失败都可能是它导致的。批量去除脚本是必备工具,每次部署前跑一遍」「编码统一是根本,整个项目从文件到数据库到页面声明全部UTF-8无BOM,BOM头和乱码问题都不会有。新团队建立时就要把编码规范定好」。
安全提醒:批量去除BOM头的PHP脚本上传到网站后,使用完立即删除,不要留在服务器上被他人访问。不要用不明来源的第三方工具处理网站文件,可能植入恶意代码。编辑器从官方渠道下载,避免被篡改。文件编码转换不会改变文件内容(除了删除BOM头三个字节),但操作前备份是好习惯。如果转换后文件内容异常,用备份恢复。

更新时间:2026-08-27 12:49:14