网站程序安装后乱码_BOM头排查与清理
很多站长遇到网站页面顶部有一行空白、验证码图片显示叉号、登录后session不生效、接口返回JSON解析失败等问题，排查半天找不到原因，最后发现是文件有BOM头。BOM头是不可见字符，在编辑器中看不到，但在PHP执行时会作为输出发送到浏览器，导致header()、session_start()、setcookie()等函数失败（因为HTTP头必须在任何输出之前发送）。本文系统讲解BOM头的检测和去除方法，覆盖主流编辑器（Notepad++、VSCode、Sublime、Dreamweaver）和批量脚本（PHP、Python、Linux命令、PowerShell），帮助彻底解决BOM头问题。
PHP脚本批量去除网站BOM头（适合虚拟主机用户）。把以下脚本保存为remove_bom.php，上传到网站根目录，浏览器访问http://域名/remove_bom.php，脚本会自动扫描当前目录及子目录下的所有PHP、HTML、CSS、JS、TXT文件，去除BOM头并显示处理结果。代码：<?php header('Content-Type: text/html; charset=utf-8'); $dir = __DIR__; $iterator = new RecursiveIteratorIterator(new RecursiveDirectoryIterator($dir)); $count = 0; foreach ($iterator as $file) { if ($file->isFile() && in_array(strtolower($file->getExtension()), ['php','html','htm','css','js','txt','xml','json'])) { $f = fopen($file->getPathname(), 'r'); $bom = fread($f, 3); fclose($f); if ($bom == pack('CCC', 0xEF, 0xBB, 0xBF)) { $content = file_get_contents($file->getPathname()); $content = substr($content, 3); file_put_contents($file->getPathname(), $content); echo '已去除BOM: ' . $file->getPathname() . '
'; $count++; } } } echo '
处理完成，共去除 ' . $count . ' 个文件的BOM头。'; ?>。使用后务必删除此脚本，避免被他人访问。
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头导致的其他问题。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头导致验证码不显示的原理。验证码图片通过PHP的GD库生成，用header('Content-Type: image/png')设置内容类型，然后输出图片二进制数据。如果PHP文件有BOM头，BOM头会在图片数据之前输出，导致浏览器接收到的数据是「BOM头 + 图片数据」，不是合法的PNG格式，浏览器无法解析，显示为叉号或空白。解决方法是去除生成验证码的PHP文件（以及include的所有文件）的BOM头。注意不仅验证码文件本身不能有BOM头，它include/require的所有文件（如数据库配置文件、函数库文件）也不能有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头。
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。
开发者真实体验：「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-08-27 10:53:51
上一篇：GBK搜索UTF-8_urlencode与数据库字符集