MySQL Server 5.7 Windows 安裝配置圖解：含 Workbench 中文包與 C# 開發注意事項

MySQL Server 5.7 Windows 安裝配置圖解：含 Workbench 中文包與 C# 開發注意事項

本文提供 MySQL Server 5.7 在 Windows 環境下的圖形化安裝全流程、官方管理工具 MySQL Workbench 安裝與中文語言包配置、C# 開發連接關鍵點，適合 Windows 開發者快速搭建本地開發環境。

一、MySQL Server 安裝步驟

1. 下載 mysql-installer-web-community-5.7.x.msi（官網或鏡像站）
2. 雙擊運行 → 選擇 Custom 自定義安裝
3. 勾選組件：MySQL Server 5.7.x、MySQL Workbench 6.3+、Connector/NET（C# 驅動）、Documentation
4. 類型選擇：Development Machine（開發機）或 Server Machine（服務器），自動調優參數
5. 認證方式：Use Strong Password Encryption（推薦 caching_sha2_password）
6. 設置 root 密碼、添加應用用戶
7. Windows 服務名：默認 MySQL57，勾選 Start Service at Startup
8. 端口：默認 3306，防火牆自動開放
9. 完成安裝，自動啟動服務

驗證：命令行 mysql -uroot -p 登錄成功。

二、MySQL Workbench 安裝與中文化

1. 安裝器中勾選 Workbench 或單獨下載 mysql-workbench-community-6.3.x-winx64.msi
2. 下載中文語言包（社區翻譯）：workbench_zh_CN.zip
3. 解壓，將 zh_CN 目錄複製至 Workbench 安裝目錄 data\languages\ 覆蓋
4. 啟動 Workbench → Edit → Preferences → General → Language 選擇 Chinese (Simplified) → 重啟生效

三、解決中文亂碼（核心配置）

1. 修改 my.ini（安裝目錄或 C:\ProgramData\MySQL\MySQL Server 5.7\my.ini）

[mysqld]
character-set-server=utf8mb4
collation-server=utf8mb4_general_ci
init_connect='SET NAMES utf8mb4'
skip-character-set-client-handshake

[client]
default-character-set=utf8mb4

[mysql]
default-character-set=utf8mb4

2. 重啟服務

net stop MySQL57
net start MySQL57

3. 驗證

SHOW VARIABLES LIKE 'character_set%';
SHOW VARIABLES LIKE 'collation%';

均顯示 utf8mb4 即成功。

四、C# 開發連接關鍵點

1. NuGet 安裝驅動

Install-Package MySql.Data

2. 連接字符串最佳實踐

Server=localhost;Port=3306;Database=testdb;Uid=appuser;Pwd=apppass;
CharSet=utf8mb4;SslMode=None;AllowUserVariables=True;ConnectionTimeout=30;

3. 核心代碼模板

using MySql.Data.MySqlClient;
using System.Data;

public class MySqlHelper {
    private static string connStr = ConfigurationManager.ConnectionStrings["MySQL"].ConnectionString;

    public static int ExecuteNonQuery(string sql, params MySqlParameter[] pars) {
        using (var conn = new MySqlConnection(connStr))
        using (var cmd = new MySqlCommand(sql, conn)) {
            if (pars != null) cmd.Parameters.AddRange(pars);
            conn.Open();
            return cmd.ExecuteNonQuery();
        }
    }

    public static DataTable ExecuteDataTable(string sql, params MySqlParameter[] pars) {
        using (var conn = new MySqlConnection(connStr))
        using (var cmd = new MySqlCommand(sql, conn))
        using (var da = new MySqlDataAdapter(cmd)) {
            if (pars != null) cmd.Parameters.AddRange(pars);
            var dt = new DataTable();
            da.Fill(dt);
            return dt;
        }
    }
}

4. 參數化查詢防注入

string sql = "INSERT INTO users(username, email) VALUES(@u, @e)";
var pars = new[] {
    new MySqlParameter("@u", "zhangsan"),
    new MySqlParameter("@e", "zs@example.com")
};
MySqlHelper.ExecuteNonQuery(sql, pars);

五、常見問題

六、總結

Windows 下 MySQL 安裝圖形化友好，關鍵在於：安裝時選對組件、my.ini 統一 utf8mb4、Workbench 中文包覆蓋 languages 目錄、C# 用 MySql.Data 參數化查詢、連接字符串關閉 SSL。開發機建議啟用 General Log、Slow Query Log 便於調試。