VS Code保存HTML后中文乱码主因是文件编码与不匹配或BOM干扰:需先通过“Reopen with Encoding”确认原始编码,再“Save with Encoding”选UTF-8(无BOM);同时确保为内首标签,并检查服务器响应头Content-Type是否覆盖charset。

VS Code 保存 HTML 后中文变乱码,基本就是文件实际编码和 <meta charset="UTF-8"> 不匹配,或者 BOM 干扰了 charset 解析。不是浏览器问题,是编辑器存错了。
VS Code 保存时编码选错(最常见)
VS Code 状态栏右下角显示的编码,不一定是你当前文件的真实编码;它只是“当前认为的编码”。如果你打开一个 GBK 编码的 HTML 文件,VS Code 可能自动识别为 GBK 并显示在状态栏,但你直接 Ctrl+S,它会按“当前识别的编码”原样保存——也就是继续存成 GBK,而页面里却写了 <meta charset="UTF-8">,必然乱码。
- 务必先确认状态栏显示的是
UTF-8(不是GBK、GB2312或ISO-8859-1) - 如果不是,点击状态栏编码 → 选择
Reopen with Encoding→ 选GBK(或其他疑似原始编码),看中文是否正常显示 - 再点击状态栏 →
Save with Encoding→ 严格选UTF-8(注意:不是UTF-8 with BOM) - 保存后刷新页面,乱码通常立即消失
BOM 导致 <meta charset> 失效
Windows 下某些编辑器(包括旧版 VS Code 默认行为)会把 UTF-8 文件存成 UTF-8 with BOM,开头多出 3 字节 EF BB BF。HTML 解析器只扫描前 1024 字节找 charset,BOM 占了头三位,<meta charset="UTF-8"> 若不在前 1024 字节内(比如被注释或空行隔开),就会 fallback 到系统默认编码(Windows 是 GBK),乱码就来了。
- 用命令验证:
head -c 4 index.html | xxd(Linux/macOS)或Get-Content index.html -Encoding Byte | Select -First 3(PowerShell),输出239, 187, 191就是 BOM - VS Code 中按 Ctrl+Shift+P → 输入
Save with Encoding→ 选UTF-8(明确不含 BOM) - 确保
<meta charset="UTF-8">是内第一个标签,前面不能有空行、注释或 U+200B 零宽空格
服务器响应头覆盖了 <meta>
只要走 HTTP(http:// 或 https://),浏览器优先信任响应头里的 Content-Type,而不是 <meta>。如果 Nginx/Apache/Node.js 返回了 Content-Type: text/html; charset=gbk,哪怕 <meta> 写得再对也白搭。
立即学习“前端免费学习笔记(深入)”;
- F12 打开 Network → 刷新 → 点 HTML 请求 → 查看 Response Headers 里的
Content-Type - Nginx 配置加
charset utf-8;(在http或server块) - Express 中在
res.send()前调用res.set("Content-Type", "text/html; charset=utf-8") - PHP 中在
<?php开头就写header("Content-Type: text/html; charset=utf-8");
BOM 和响应头这两处最容易被忽略——前者藏在文件开头看不见,后者根本不在 HTML 源码里。改完编码后一定要用命令行或开发者工具双重验证,别只盯着 <meta> 标签本身。



















