萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> CMS 教學

WordPress 模板添加中文前台顯示亂碼?UTF-8 編碼統一解決方案

WordPress 核心、數據庫、主題、插件全鏈路要求 UTF-8 編碼。模板文件若為 GB2312/ANSI 編碼保存,前台輸出中文必現亂碼(、方塊、亂碼字符)。本文提供兩種徹底修復方案,並釐清編碼鏈路關鍵點。

現象與根因

  • 現象:前台頁面中文顯示為 、□、亂碼、問號
  • 根因:模板文件(.php/.html/.css/.js)實際編碼 ≠ HTTP 響應頭 Content-Type: text/html; charset=UTF-8 聲明編碼
  • 鏈路:文件編碼 → PHP 讀取 → 輸出 → HTTP Header → 瀏覽器解碼,任一環節不一致即亂碼

方案一:Notepad++ 批量轉碼(推薦,適用本地開發)

  1. FTP 下載全部主題文件到本地
  2. Notepad++ 打開文件 → 菜單「編碼」→ 「轉為 UTF-8 編碼」(注意:選「轉為」,而非「以 UTF-8 編碼打開」)
  3. 另存為,覆蓋原文件
  4. 批量處理:文件 → 批量轉碼,選中整個主題目錄,目標編碼選 UTF-8,執行
  5. 上傳覆蓋遠程文件

Notepad++ 另存為 UTF-8 編碼選單 批量轉碼對話框

方案二:Windows 記事本「另存為」指定 UTF-8(無需安裝工具)

  1. FTP 下載目標文件(如 footer.php)
  2. 改後綴 .txt(避免系統關聯直接執行)
  3. 雙擊打開 → 文件 → 另存為 → 編碼下拉選 UTF-8(非 UTF-8 with BOM) → 保存
  4. 改回 .php,上傳覆蓋

關鍵: 必須選「UTF-8」,不是「UTF-8 with BOM」。BOM 會導致 PHP 輸出時在文件頭輸出隱形字符,破壞 HTTP Header、Session、Cookie、重定向。

系統級編碼一致性檢查清單

常見誤區

  • ❌ 以為數據庫是 utf8 就夠了 — 文件編碼不同步同樣亂碼
  • ❌ 用「以 UTF-8 編碼打開」而非「轉為 UTF-8 編碼」 — 只是重新解讀位流,不改變文件字節
  • ❌ 保存為 UTF-8 with BOM — 破壞 PHP 輸出、JSON API、XML Sitemap
  • ❌ 只改前台模板,後台編輯器輸入的中文入庫編碼錯誤 — 需確保 DB_CHARSET 正確

一鍵診斷腳本

在主題 functions.php 臨時添加:

add_action('wp_head', function() {
    echo '<!-- DB_CHARSET: ' . DB_CHARSET . ' -->';
    echo '<-- FILE_ENCODING: ' . mb_detect_encoding(file_get_contents(__FILE__)) . ' -->';
});

前台查看源碼註釋,確認編碼鏈路一致。


WordPress 官方強制要求 UTF-8,無例外。養成「新建文件即存為 UTF-8 無 BOM」習慣,配合編輯器自動檢測,從源頭杜絕亂碼。

copyright © 萬盛學電腦網 all rights reserved
層級檢查項正確值驗證方法
文件模板/插件/JS/CSS 文件編碼UTF-8 (無 BOM)Notepad++ / VS Code 底部編碼顯示
數據庫數據庫/表/字段校對規則utf8mb4_general_ciphpMyAdmin 結構頁 / SHOW CREATE TABLE
連接wp-config.phpdefine('DB_CHARSET', 'utf8mb4');打開文件確認
PHPphp.ini / .user.inidefault_charset = "UTF-8"phpinfo() 查看
Web ServerNginx/Apache 響應頭Content-Type: text/html; charset=utf-8DevTools Network → Response Headers
HTMLmeta charset 聲明<meta charset="utf-8"> 在 <head> 首行查看頁面源碼