WordPress 核心、數據庫、主題、插件全鏈路要求 UTF-8 編碼。模板文件若為 GB2312/ANSI 編碼保存,前台輸出中文必現亂碼(、方塊、亂碼字符)。本文提供兩種徹底修復方案,並釐清編碼鏈路關鍵點。
現象與根因
- 現象:前台頁面中文顯示為 、□、亂碼、問號
- 根因:模板文件(.php/.html/.css/.js)實際編碼 ≠ HTTP 響應頭
Content-Type: text/html; charset=UTF-8 聲明編碼
- 鏈路:文件編碼 → PHP 讀取 → 輸出 → HTTP Header → 瀏覽器解碼,任一環節不一致即亂碼
方案一:Notepad++ 批量轉碼(推薦,適用本地開發)
- FTP 下載全部主題文件到本地
- Notepad++ 打開文件 → 菜單「編碼」→ 「轉為 UTF-8 編碼」(注意:選「轉為」,而非「以 UTF-8 編碼打開」)
- 另存為,覆蓋原文件
- 批量處理:
文件 → 批量轉碼,選中整個主題目錄,目標編碼選 UTF-8,執行
- 上傳覆蓋遠程文件

方案二:Windows 記事本「另存為」指定 UTF-8(無需安裝工具)
- FTP 下載目標文件(如
footer.php)
- 改後綴
.txt(避免系統關聯直接執行)
- 雙擊打開 → 文件 → 另存為 → 編碼下拉選 UTF-8(非 UTF-8 with BOM) → 保存
- 改回
.php,上傳覆蓋
關鍵: 必須選「UTF-8」,不是「UTF-8 with BOM」。BOM 會導致 PHP 輸出時在文件頭輸出隱形字符,破壞 HTTP Header、Session、Cookie、重定向。
系統級編碼一致性檢查清單
| 層級 | 檢查項 | 正確值 | 驗證方法 |
| 文件 | 模板/插件/JS/CSS 文件編碼 | UTF-8 (無 BOM) | Notepad++ / VS Code 底部編碼顯示 |
| 數據庫 | 數據庫/表/字段校對規則 | utf8mb4_general_ci | phpMyAdmin 結構頁 / SHOW CREATE TABLE |
| 連接 | wp-config.php | define('DB_CHARSET', 'utf8mb4'); | 打開文件確認 |
| PHP | php.ini / .user.ini | default_charset = "UTF-8" | phpinfo() 查看 |
| Web Server | Nginx/Apache 響應頭 | Content-Type: text/html; charset=utf-8 | DevTools Network → Response Headers |
| HTML | meta charset 聲明 | <meta charset="utf-8"> 在 <head> 首行 | 查看頁面源碼 |
常見誤區
- ❌ 以為數據庫是 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