必须紧贴开头,因浏览器仅扫描前1024字节查找该标签,若遇中文、emoji、BOM或等非ASCII内容即中断扫描,fallback至系统默认编码(如Windows的GBK),导致乱码或JS语法错误。

meta charset="UTF-8" 必须放在 开头、任何其他标签(包括 和 <script></script>)之前,否则浏览器可能已按默认编码(如 Windows 的 GBK)开始解析,导致中文乱码或 JS 报 Invalid or unexpected token。
为什么 meta charset 要紧贴 开头?
浏览器只扫描 HTML 文件前 1024 字节来查找 meta charset;一旦遇到非 ASCII 字符(比如中文注释、emoji、BOM 或 里的中文),就会中断扫描, fallback 到系统默认编码。哪怕你写了 ,只要它不在前 1024 字节的纯 ASCII 区域内,就大概率失效。
- 常见错误:把
放在后面,或前面加了中文注释 - 更隐蔽的坑:VS Code 默认保存为 “UTF-8 with BOM”,BOM(
EF BB BF)占 3 字节,会把推到第 4 字节之后——但某些旧版解析器仍可能误判 - 验证方式:用
xxd -l 4 index.html(Linux/macOS)或Get-Content index.html -Encoding Byte | Select -First 3(PowerShell)确认开头是3c 68 74 6d(即),而不是 ef bb bf
文件实际编码、HTTP 响应头、meta 三者必须一致
浏览器按优先级取编码:HTTP Content-Type 响应头 > meta charset > 系统默认。哪怕 meta 写对了,如果服务器返回 Content-Type: text/html; charset=GBK,页面照样按 GBK 解析,中文变乱码。
- Nginx 配置要写
charset utf-8;(小写,不能带等号或引号) - Apache 需在
.htaccess中加AddDefaultCharset UTF-8(注意大小写) - Node.js/Express 中用
res.set('Content-Type', 'text/html; charset=UTF-8'),不能只靠res.sendFile() - 本地双击打开(
file://协议)时,HTTP 头无效,全依赖meta和文件实际编码
编辑器保存设置常被忽略
VS Code、Sublime Text、Notepad++ 默认可能用 ANSI(Windows)、ISO-8859-1(macOS/Linux)保存 HTML 文件。即使你写了 meta charset="UTF-8",文件本身是 GBK 编码,浏览器读到的仍是错的字节流。
- VS Code:保存时选
Save with Encoding → UTF-8(**不要选 “UTF-8 with BOM”**) - Sublime Text:菜单
File → Save with Encoding → UTF-8 - Notepad++:菜单
编码 → 转为 UTF-8 无 BOM 格式 - 验证文件真实编码:Linux/macOS 用
file -i index.html;Windows 用 PowerShellGet-Content index.html -Encoding Byte | Select -First 10查看原始字节
BOM 是最易被低估的干扰项——它不显示、不报错,却能悄悄让 meta charset 失效;HTTP 响应头和文件编码不一致时,问题往往出现在部署环节而非开发阶段;三者中只要一个掉链子,中文就大概率出问题。
前端入门到VUE实战笔记:立即使用
在学习笔记中,你将探索 前端 的入门与实战技巧!











