| 現象 | 可能原因 | 解決方向 |
|---|---|---|
| 雙擊無反應/開啟其他程式 | 檔案關聯錯誤 | 設定預設開啟程式為瀏覽器 |
| 顯示原始碼而非渲染 | 副檔名非 .html/.htm、Content-Type 錯誤 | 改副檔名、伺服器設定 MIME |
| 中文亂碼/問號/方塊字 | 編碼宣告缺失或不匹配 | 補 <meta charset="UTF-8">、存檔為 UTF-8 |
| 圖片/樣式/腳本載入失敗 | 相對路徑錯誤、CORS、CSP | 修正路徑、檢查網路面板 |
Content-Type: text/html; charset=UTF-8(最高)<meta charset="UTF-8"> (HTML5) / <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
3. <?xml encoding="UTF-8"?> (XHTML)
4. 瀏覽器啟發式偵測
5. 使用者手動選單覆蓋
早期繁體中文網頁常用 Big5,簡體用 GB2312 (或 GBK/GB18030)。若檔案實為 UTF-8 卻宣告 Big5,或反之,即會亂碼。
現代標準:統一使用 UTF-8,支援全語言、Emoji、無編碼轉換困擾。
file -i filename.html (Linux/macOS) 檢測實際編碼| 情境 | 路徑解析 | 常見問題 |
|---|---|---|
本地 file:// 協定 | 絕對路徑、相對路徑 | CORS 阻擋 ES 模組、Ajax、字體、iframe |
本地 HTTP Server (VS Code Live Server, npx serve, python -m http.server) | 同網域相對路徑 | 最接近正式環境,建議開發時使用 |
| 正式部署 (Nginx, Apache, CDN) | 根相對路徑 /assets/ | 需設定正確 MIME、快取、壓縮、CSP |
.html 或 .htm?<!DOCTYPE html>?
3. <head> 第一行有 <meta charset="UTF-8">?
4. 檔案實際儲存編碼是 UTF-8 (無 BOM)?
5. 用 本地 HTTP Server** 開啟而非雙擊?
6. 開發者工具 Network 面板看回應 Header 的 charset?
7. Console 有紅字錯誤(CORS、CSP、404)?