必须统一将HTML文件转为UTF-8（无BOM）并补全<meta charset="UTF-8">，缺一不可；若仅修改meta标签而文件实际为GBK编码，浏览器会用UTF-8解码GBK字节，导致方块或问号乱码。
批量修改 HTML 文件编码，核心就一条：统一转为 UTF-8（无 BOM），并补全 <meta charset="UTF-8">。缺一不可，否则浏览器仍可能乱码。
为什么不能只改 <meta charset> 标签？
因为浏览器读取 HTML 时，会先按文件实际字节解码——如果文件本身是 GBK 编码，但你只在 <head> 里写 <meta charset="UTF-8">，浏览器会用 UTF-8 去解码 GBK 字节，结果就是一堆 和乱码。标签只是“声明”，不是“转换”。
- 常见错误现象：
<meta charset="UTF-8">已存在，但中文仍显示为方块或问号 - 本质原因：文件磁盘上存的是 GBK 字节，却用 UTF-8 解码
- 验证方式：用十六进制编辑器（如 HxD）打开文件，看开头是否为
EF BB BF（UTF-8 BOM）或纯文本是否可读
Windows 下用 PowerShell 批量转码（推荐）
适用于 .html / .htm 文件集中在一个文件夹内，且当前编码已知（如 GBK）。PowerShell 命令可直接重写文件内容，不依赖第三方工具。
- 确认当前编码：先用 VS Code 打开一个典型文件，右下角查看当前识别的编码（如
GBK或GB2312） - 执行命令（以当前目录下所有
.html文件从 GBK 转 UTF-8 为例）：powershell -Command "Get-ChildItem *.html | ForEach-Object { $c = Get-Content $_.FullName -Encoding Default; Set-Content $_.FullName -Value $c -Encoding UTF8 }" - 注意：
-Encoding Default在 Windows 上默认对应系统 ANSI（即 GBK），若实际是 ISO-8859-1，需显式写-Encoding ASCII - 风险提示：该操作覆盖原文件，建议先备份整个文件夹
Linux/macOS 下用 iconv 批量处理
更可控、更通用，适合 CI/CD 或脚本集成。iconv 是系统级工具，无需安装额外依赖。
立即学习“前端免费学习笔记（深入）”；
- 检查当前编码（示例）：
file -i index.html→ 输出含charset=iso-8859-1或charset=gbk - 批量转换（GBK → UTF-8，保留原文件名）：
for f in *.html; do iconv -f GBK -t UTF-8 "$f" -o "${f%.html}_utf8.html"; done - 若要覆盖原文件（谨慎！）：
for f in *.html; do iconv -f GBK -t UTF-8 "$f" -o "$f.tmp" && mv "$f.tmp" "$f"; done
- 兼容性注意：macOS 的
iconv不支持GBK，需用giconv（通过brew install libiconv安装）
补全 <meta charset="UTF-8"> 的安全写法
批量转码后，必须确保每个 HTML 文件的 <head> 内第一位置有该标签。手写容易漏或位置错，建议用 sed / awk 或简单脚本注入。
- Linux/macOS（插入到
<head>后）：sed -i '/<head>/a \<meta charset="UTF-8">' *.html
- Windows PowerShell（更稳妥，避免匹配失败）：
(Get-Content file.html) -replace '<head>', '<head><meta charset="UTF-8">' | Set-Content file.html
- 关键细节：
<meta charset>必须在<title>之前；不能写成<meta http-equiv="Content-Type" ...>，后者兼容性差且易被忽略 - 验证技巧：打开任意一个修改后的文件，在浏览器按 F12 → Console 输入
document.characterSet，应返回"UTF-8"
真正麻烦的不是转码动作本身，而是混合编码场景：一个项目里有的 HTML 是 UTF-8（无 BOM），有的带 BOM，有的是 GBK，还夹着几个 ISO-8859-1 的旧模板。这种情况下，批量脚本会出错，必须先分类再处理——别跳过编码探测这步。
