一、代码编辑工具规范(必看)
在修改、编辑网站PHP程序文件时,编辑器的选择直接决定网站能否正常运行,错误的编辑方式极易导致网站空白、解析失败、程序报错等各类疑难问题,严格遵循以下工具使用规范:
1、推荐使用专业代码编辑器
建站与程序开发请统一使用专业编辑器,适配代码编写规范、自带语法高亮、代码补全、函数提示功能,从根源规避编码错误。推荐工具:Notepad++、Dreamweaver、PhpStorm。
2、严禁使用的编辑方式
禁止使用系统自带记事本、写字板、TXT文本工具,同时禁止通过FTP工具、主机后台在线编辑PHP文件。
此类工具无代码语法适配能力,不仅没有代码高亮、补全、函数提示功能,还会默认生成多余的BOM头部字符、篡改文件编码,导致程序出现隐性报错、网页解析失败、网站空白打不开等莫名故障,且这类问题极难排查。
二、错误编辑引发的常见故障
若使用非专业工具编辑PHP文件后,出现网站后台空白、前台无法访问、网页解析失败、不支持网页类型等问题,基本可以判定是文件编码异常、BOM非法字符导致的程序故障,需要通过专用脚本检测修复。
三、BOM异常检测脚本使用教程
针对文件编码异常、BOM乱码导致的网站报错,可使用官方专用检测脚本,一键排查异常文件,精准定位问题并修复。
脚本下载地址:https://gitee.com/dayrui/tool/blob/master/bom.php
使用步骤:
- 下载上方 bom.php 检测脚本文件;
- 将脚本文件上传至网站根目录;
- 浏览器访问该脚本,执行全站文件检测。
检测结果判断:
页面无红色字体提示,代表网站所有文件编码正常、无BOM异常;若页面出现红色字体标注,代表对应文件存在编码异常、带有非法BOM字符,需要手动修复。

四、BOM异常文件修复方案
针对检测出的异常文件,统一使用 Notepad++ 专业编辑器修复,操作简单且适配程序编码规范:
- 用 Notepad++ 打开报错的异常文件;
- 找到顶部编码设置,将文件编码转换为 UTF-8 无BOM格式;
- 清除文件多余的BOM头部字符,保存文件即可完成修复。
修复完成后刷新网站,即可解决网页解析失败、网站空白、程序打不开等各类因编码、BOM异常引发的故障。
