萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 資料庫 >> MySQL 教學

MySQL 中文亂碼完整解決方案:編碼一致性實戰指南

前言:為什麼中文亂碼總是纏身?

在 MySQL 開發中,中文亂碼幾乎總是由編碼不一致引起的。無論是資料庫層面、應用程式層面,還是連線層面,只要有一個環節編碼設定錯誤,資料就會變成不可讀的亂碼。本文將透過系統性的實測,徹底釐清三大關鍵因素的交互影響,幫助你建立一套「零亂碼」的開發規範。

三大核心影響因素

導致中文亂碼的主因僅有三個,必須同時滿足一致性:

  1. 資料表字符集(CHARSET=utf8/utf8mb4/gbk)
  2. PHP 檔案編碼(儲存時的編碼格式)
  3. 連線執行編碼(mysql_query("SET NAMES charset"))

實測場景與結果總結

筆者設計了多組控制實驗,固定前兩個條件,僅變更第三個條件,觀察中文顯示情況。以下為關鍵發現:

場景一:資料表 UTF-8,PHP 檔案 GB2312

  • SET NAMES gbk → 亂碼
  • SET NAMES gb2312 → 亂碼
  • SET NAMES utf8 → 正常
  • 不執行 SET NAMES → 亂碼

結論:資料表為 UTF-8 時,無論 PHP 檔案編碼為何,必須在寫入前執行 SET NAMES utf8。

場景二:資料表 UTF-8,PHP 檔案 UTF-8

  • SET NAMES gbk → 亂碼
  • SET NAMES gb2312 → 亂碼
  • SET NAMES utf8 → 正常
  • 不執行 SET NAMES → 亂碼

結論:PHP 檔案編碼改為 UTF-8 後,結果與場景一完全一致。PHP 檔案編碼本身不直接決定資料庫寫入是否亂碼,關鍵在於 SET NAMES 與資料表字符集是否一致。

場景三:資料表 GBK,PHP 檔案 GB2312

  • SET NAMES gbk → 亂碼
  • SET NAMES gb2312 → 亂碼
  • SET NAMES utf8 → 正常
  • 不執行 SET NAMES → 亂碼

驚人發現:即使資料表是 GBK,PHP 是 GB2312,執行 SET NAMES utf8 反而能正常顯示!這說明 MySQL 會自動進行字符集轉換,只要連線層宣告的編碼(SET NAMES)與資料實際編碼(PHP 檔案編碼)一致,資料庫就能正確解碼並轉存為表定義的字符集。

最佳實踐建議

  1. 統一使用 UTF-8(推薦 utf8mb4):資料表、PHP 檔案、HTML 頁面、連線編碼全鏈路保持一致。
  2. 連線建立後立即執行 SET NAMES utf8mb4,確保傳輸層編碼正確。
  3. 資料庫預設字符集設為 utf8mb4,避免新建表時遺漏指定。
  4. 檢查 my.cnf:[mysqld] character-set-server=utf8mb4、[client] default-character-set=utf8mb4。

程式碼範例(PDO 版)

$dsn = "mysql:host=localhost;dbname=test;charset=utf8mb4";
$pdo = new PDO($dsn, $user, $pass, [
    PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION,
    PDO::MYSQL_ATTR_INIT_COMMAND => "SET NAMES utf8mb4"
]);

遵循「全鏈路 UTF-8」原則,中文亂碼問題將徹底成為歷史。

copyright © 萬盛學電腦網 all rights reserved