在 Mac 上裝好 MySQL 之後,即使連線時協商出 utf8,伺服器與資料庫層級的預設字符集往往仍是 latin1。這代表之後新建的資料庫與資料表都會是 latin1,寫入中文時很容易出問題,所以有必要從設定檔改掉。
mysql> show variables like '%char%';
重點看這三項:
| character_set_client | utf8 | | character_set_connection| utf8 | | character_set_database | latin1 | | character_set_server | latin1 |
character_set_database 與 character_set_server 是 latin1,就必須處理。
修改 my.cnf 之前一定要先停掉 mysqld,否則重啟時會遇到 socket 無法連線的問題。
Mac 上最省事的方式是到「系統偏好設定」裡的 MySQL 面板,點擊 Stop MySQL Server,不必去找安裝路徑。



先把範例設定檔複製過去:
sudo cp /usr/local/mysql/support-files/my-medium.cnf /etc/my.cnf sudo vi /etc/my.cnf
在 [client] 區段加入:
default-character-set = utf8
在 [mysqld] 區段加入:
character-set-server = utf8
存檔後重新啟動 MySQL。
mysql> show variables like '%char%';
確認 character_set_database 與 character_set_server 都已變成 utf8 即完成。
第一,改設定不會影響已存在的資料庫與資料表。既有的表仍是 latin1,若要轉換需另外執行 ALTER TABLE ... CONVERT TO CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;,且務必先備份。
第二,現在更推薦使用 utf8mb4 而非 utf8。MySQL 的 utf8 其實是「每字元最多 3 位元組」的精簡版,無法儲存 emoji 與部分罕用 CJK 字(如「𠮷」),會導致寫入失敗或出現問號。utf8mb4 才是完整的 UTF-8。因此上面兩行建議改寫為:
default-character-set = utf8mb4 character-set-server = utf8mb4
並在 [mysqld] 加一組 collation-server = utf8mb4_unicode_ci。
第三,MySQL 8.0 之後的預設字符集已是 utf8mb4,通常不需要再手動設定。若你安裝的是 8.0 以上版本卻看到 latin1,該檢查的是連線時的 client 設定或 JDBC/PDO 連線字串,而不是伺服器設定檔。