現象:打開 HTML 文件內容不見/亂碼/問號框
常見表現:中文顯示「鏈濂」、「????」、或頁面空白無報錯。
根因一:缺失編碼聲明,瀏覽器猜錯
HTML 文件保存為 UTF-8,但 `
` 無 `
`,瀏覽器按系統區域猜測:
- 簡體 Windows → GBK/GB2312
- 繁體 Windows/macOS → Big5
- Linux → UTF-8 (通常正確)
修復:`
` **第一行**寫 `
` (HTML5) 或 `
`。
根因二:UTF-8 with BOM (Byte Order Mark) 干擾
部分編輯器 (舊版 Notepad、部分 Windows 工具) 保存 UTF-8 時在文件頭插入 `EF BB BF` 三字節 BOM。後果:
- 舊版 IE/瀏覽器將 BOM 視為可見字符,導致頁面頂部出現隱形空白/亂碼。
- 破壞 `` 必須位於文件最開頭的要求,觸發怪異模式。
修復:編輯器「另存為」選 **UTF-8 (無 BOM)** / **UTF-8 without BOM**。VS Code 右下角編碼點擊 → "Save with Encoding" → UTF-8。
根因三:服務端響應頭與文件聲明衝突
HTTP 響應頭 `Content-Type: text/html; charset=GB2312` 但文件實為 UTF-8。**HTTP 標頭優先級最高**,瀏覽器按 GB2312 解碼 UTF-8 位元組 → 亂碼。
修復:
- Nginx: `charset utf-8;` / `add_header Content-Type "text/html; charset=utf-8";`
- Apache: `AddDefaultCharset UTF-8` 或 `.htaccess` `AddCharset UTF-8 .html`
- Java/Spring: `response.setCharacterEncoding("UTF-8"); response.setContentType("text/html;charset=UTF-8");`
- PHP: `header('Content-Type: text/html; charset=UTF-8');`
- Node/Express: `res.set('Content-Type', 'text/html; charset=utf-8');`
排查檢查清單 (按優先級)
- 文件是否真實保存為 UTF-8 無 BOM? (VS Code/Notepad++ 右下角確認)
- `` 首行是否有 ``?
- HTTP 響應頭 `Content-Type` charset 是否為 UTF-8? (DevTools Network → Headers 查看)
- 是否混雜編碼? (部分片段 GBK、部分 UTF-8) → 統一轉碼全站 UTF-8。
- 字體是否缺字? (顯示 □/ 但非編碼問題) → 補全字體或 Web Font。
一鍵診斷命令
# 檢測文件編碼
file -i index.html
# 輸出: text/html; charset=utf-8
# 檢測 BOM
xxd index.html | head -1
# 無 BOM: 3c 21 44 4f 43 54 59 50 45 20 68 74 6d 6c ...
# 有 BOM: ef bb bf 3c 21 44 4f 43 54 59 50 45 20 68 74 6d 6c ...
總結
**「文件 UTF-8 無 BOM + meta charset 首行 + HTTP 標頭 UTF-8」三位一體**,徹底根治 HTML 亂碼。建議在 CI/CD 流水線加入編碼檢查腳本,禁止帶 BOM 或非 UTF-8 文件入庫。