萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網頁製作 >> HTML5 教學

HTML 文件打開顯示亂碼/空白?編碼聲明缺失、BOM 干擾、服務端響應頭衝突三大根因與解決方案

現象:打開 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');`

排查檢查清單 (按優先級)

  1. 文件是否真實保存為 UTF-8 無 BOM? (VS Code/Notepad++ 右下角確認)
  2. `` 首行是否有 ``?
  3. HTTP 響應頭 `Content-Type` charset 是否為 UTF-8? (DevTools Network → Headers 查看)
  4. 是否混雜編碼? (部分片段 GBK、部分 UTF-8) → 統一轉碼全站 UTF-8。
  5. 字體是否缺字? (顯示 □/ 但非編碼問題) → 補全字體或 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 文件入庫。

copyright © 萬盛學電腦網 all rights reserved