萬盛學電腦網

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

MySQL 命令列還原 phpMyAdmin 匯出含中文 SQL 檔:編碼正確設定關鍵步驟

問題場景

phpMyAdmin 匯出 UTF-8 編碼的 `.sql` 檔 (含 `INSERT` 語句),使用 MySQL 命令列 `SOURCE` 匯入時,中文顯示亂碼或報錯 `Incorrect string value`。

根本原因

MySQL 客戶端連線預設字符集 (`character_set_client/connection/results`) 與 **SQL 檔案實際編碼不一致**。phpMyAdmin 匯出通常為 **UTF-8**,但命令列預設可能為 `latin1`、`gbk` 或系統預設編碼。

正確操作流程 (Windows/Linux 通用)

步驟 1:建立目標資料庫 (指定編碼)

mysql -u root -p
CREATE DATABASE TargetDB CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
USE TargetDB;

步驟 2:確認 SQL 檔案真實編碼

  • **VS Code / Notepad++ / Sublime Text** 開啟檔案,查看右下角編碼標示 (UTF-8 / UTF-8 with BOM / GBK)。
  • Linux 指令:`file -i dump.sql` → 輸出 `text/plain; charset=utf-8`。

步驟 3:設定連線編碼與檔案編碼完全一致 (關鍵)

-- 檔案為 UTF-8 (無 BOM 或有 BOM 均可)
SET NAMES utf8mb4;  -- 或 utf8 (MySQL 5.5.3 前)
-- 切勿使用: SET NAMES utf-8; (無效語法)
-- 切勿使用: SET CHARACTER SET utf8; (不設定 character_set_connection/results)

步驟 4:執行匯入

SOURCE /path/to/dump.sql;
-- Windows 路徑建議用正斜線或雙反斜線: SOURCE D:/Backup/dump.sql;

步驟 5:驗證資料正確性

SELECT * FROM TargetTable WHERE Col LIKE '%中文%' LIMIT 5;

自動化腳本範例 (Linux Bash)

#!/bin/bash
DB_USER="root"
DB_PASS="StrongPass"
DB_NAME="TargetDB"
SQL_FILE="/backup/dump_$(date -d 'yesterday' +%F).sql"
CHARSET="utf8mb4"

mysql -u"$DB_USER" -p"$DB_PASS" -e "CREATE DATABASE IF NOT EXISTS \`$DB_NAME\` CHARACTER SET $CHARSET COLLATE ${CHARSET}_unicode_ci;"
mysql -u"$DB_USER" -p"$DB_PASS" --default-character-set=$CHARSET "$DB_NAME" < "$SQL_FILE"

if [ $? -eq 0 ]; then
    echo "[$(date)] Import SUCCESS: $SQL_FILE"
else
    echo "[$(date)] Import FAILED: $SQL_FILE" >&2
    exit 1
fi

常見誤區對照

錯誤做法正確做法原因
`SET NAMES gbk;` 導入 UTF-8 檔`SET NAMES utf8mb4;`編碼必須匹配檔案實際編碼,而非資料庫預設/系統語系
用 `SET CHARACTER SET utf8;`用 `SET NAMES utf8mb4;``SET CHARACTER SET` 不設定 `character_set_connection`,隱性轉換仍會亂碼
直接 `SOURCE` 不設編碼先 `SET NAMES` 再 `SOURCE`預設連線編碼通常非 UTF-8

進階:處理混合編碼檔案

若單一 `.sql` 內混雜編碼 (極罕見),需拆分檔案分別匯入,或使用 `iconv` 統一轉碼:

iconv -f GBK -t UTF-8 dump_gbk.sql > dump_utf8.sql
# 然後 SET NAMES utf8mb4 導入 dump_utf8.sql
copyright © 萬盛學電腦網 all rights reserved