富文本HTML必须用UTF-8 without BOM,因BOM(EF BB BF)是非法前导字节,会破坏DOM解析:微信、IE及file://协议下易报错或回退GBK导致乱码,且须为内首个标签才生效。

富文本内容保存必须用 UTF-8 without BOM,否则微信、IE 或 file:// 协议下极易乱码或解析失败
为什么不能用 UTF-8 with BOM?
BOM(EF BB BF)是三个非法前导字节,在 HTML 开头会破坏 DOM 解析。微信公众号草稿箱上传、Wechat HTML Publisher 等工具遇到 BOM 会直接报错或丢弃内容;IE 和部分双击打开的本地 HTML(file:// 协议)也会因 BOM 导致 <meta charset="UTF-8"> 失效,回退到系统默认 GBK 编码,显示为 䏿–‡。
- VS Code 默认新建文件是
UTF-8 with BOM,但富文本 HTML 必须禁用它 - Notepad++ 的“转为 UTF-8”默认带 BOM,“转为 UTF-8-BOM”才是带 BOM 的选项——你要选的是“转为 UTF-8 无 BOM 格式”
- Sublime Text 的
Save with Encoding → UTF-8默认就是无 BOM,相对安全
怎么确认文件真正保存为 UTF-8 without BOM?
仅看编辑器右下角显示 UTF-8 不够,那只是当前解码方式,不代表磁盘字节已更新。
- 在 VS Code 中:按
Ctrl+Shift+P→ 输入Reopen with Encoding→ 选GBK,如果中文立刻变乱码,说明原文件不是 GBK;再选UTF-8看是否正常,确认后执行Save with Encoding → UTF-8(注意不是UTF-8 with BOM) - 终端验证:
file -i yourfile.html输出必须含charset=utf-8,且不含bom字样 - 十六进制验证:用 Hex Editor 打开,开头两个字节不能是
EF BB(BOM 标志),应直接是中文 UTF-8 字节(如E4 B8 AD表示“中”)
<meta charset> 写法和位置有硬性要求
即使文件编码正确,<meta charset> 写错位置或格式也会让浏览器忽略它。
立即学习“前端免费学习笔记(深入)”;
- 必须放在
内,且是中**第一个**标签(前面不能有任何空格、换行、注释或 BOM) - 只能写成
</meta charset="utf-8">或<meta charset="utf-8">,不能写UTF8、UTF_8、UTF-8(大小写敏感,且连字符在某些旧环境会出问题) - 不能写成
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">—— 这是 HTML4 写法,HTML5 不推荐,且部分解析器优先级更低 - 如果富文本由 CMS 或编辑器生成(如 TinyMCE、Quill),需检查其导出逻辑是否自动注入了 BOM 或错误 meta
HTTP 服务环境下还要配响应头
本地双击打开靠 <meta charset>,但走 http:// 或 https:// 时,HTTP 响应头 Content-Type 的优先级更高。
- Nginx:在
location块加charset utf-8;(不是add_header Content-Type,那会覆盖原有 header) - Express:在
res.send()前调用res.set('Content-Type', 'text/html; charset=utf-8'),不能只靠res.sendFile() - Apache:
.htaccess中写AddDefaultCharset UTF-8 - 验证方式:F12 → Network → 刷新 → 点 HTML 文件 → 查看 Response Headers 中
Content-Type是否含charset=utf-8
最常被忽略的一点:富文本 HTML 往往由后端拼接或模板引擎生成,哪怕前端文件保存正确,若服务端读取源文件时用了错误编码(比如用 fs.readFileSync(file, 'utf8') 读一个实际是 GBK 的模板),输出内容从源头就已损坏——此时改 meta、改保存方式全无效。



















