萬盛學電腦網

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

MySQL 字元集徹底設定 UTF-8:從 my.cnf 到建庫建表最佳實踐

現狀檢查

SHOW VARIABLES LIKE '%character%';
-- 若顯示 latin1,中文存取將產生亂碼

修改配置檔(永久生效)

  1. 尋找可用範本:find / -name '*.cnf' -type f 2>/dev/null | grep -E 'my-(small|medium|large|huge)'
  2. 複製至 /etc/my.cnf:cp /usr/share/mysql/my-large.cnf /etc/my.cnf
  3. 編輯 /etc/my.cnf:
    [client]
    default-character-set=utf8
    
    [mysqld]
    default-character-set=utf8
    init_connect='SET NAMES utf8'
    character-set-server=utf8
    collation-server=utf8_general_ci
    
  4. 重啟驗證:service mysql restart && mysql -e "SHOW VARIABLES LIKE '%character%';"

關鍵細節:建庫建表必須顯式指定

即使服務端預設為 UTF-8,建庫/建表若不指定仍會沿用舊預設。

CREATE DATABASE mydb DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
CREATE TABLE mytbl (id INT PRIMARY KEY, name VARCHAR(100)) 
  DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci;

建議直接使用 utf8mb4(支援 Emoji 與補充字元),utf8 實為 utf8mb3。

連線層面確認

  • JDBC URL:jdbc:mysql://host:3306/db?characterEncoding=utf8&useSSL=false
  • PHP PDO:new PDO("mysql:host=...;dbname=...;charset=utf8mb4", $user, $pass)
  • Python:charset='utf8mb4' 參數。

常見坑點

  • 修改 my.cnf 後未重啟 MySQL。
  • 舊表未轉換:ALTER TABLE tbl CONVERT TO CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
  • 應用層未設定連線字元集,導致「存入正常、讀出亂碼」。
copyright © 萬盛學電腦網 all rights reserved