Mac 安裝 MySQL 完整圖文教學（DMG 版）

Mac 安裝 MySQL 完整圖文教學（DMG 版）

在 macOS 上安裝 MySQL 最直觀的方式是使用官方提供的 DMG 安裝包。本文將從下載、安裝、初始化到啟動服務，完整記錄操作流程，並說明常見的權限與 Socket 路徑問題。

1. 下載安裝包

前往 MySQL 官方下載頁面，選擇 macOS DMG Archive。建議下載 mysql-VERSION-macos-VERSION.dmg 格式的檔案，雙擊掛載後會看到數個 .pkg 安裝程式。

2. 執行安裝程式

依序安裝以下兩個核心套件：

1. mysql-version-macos-version.pkg：主程式，預設安裝至 /usr/local/mysql-version，並建立符號連結 /usr/local/mysql 指向最新版本。
2. MySQLStartupItem.pkg：啟動項目，讓 MySQL 能在開機時自動啟動（舊版機制，新版 macOS 建議改用 launchd，參考 上一篇教學）。

注意： 若系統已存在 /usr/local/mysql 目錄，安裝程式會要求先備份（改名為 mysql.bak），安裝完成後會自動執行 mysql_install_db 初始化系統資料表與授權表。

3. 啟動 MySQL 服務

方式 A：使用 Startup Item（已安裝 MySQLStartupItem.pkg 時）

sudo /Library/StartupItems/MySQLCOM/MySQLCOM start

輸入管理員密碼後服務即啟動。若要停用開機自啟，可編輯 /etc/hostconfig 將 MYSQLCOM=-YES- 改為 MYSQLCOM=-NO-。

方式 B：手動前景啟動（未安裝 Startup Item 或除錯用）

cd /usr/local/mysql
sudo ./bin/mysqld_safe
# 按 Ctrl+Z 暫停
bg
# 按 Ctrl+D 離開 shell，服務將在背景持續運行

4. 連線測試與常見 Socket 錯誤排除

執行 /usr/local/mysql/bin/mysql -u root -p 進入客戶端。若出現 Can't connect to local MySQL server through socket '/tmp/mysql.sock' 錯誤，通常是因為客戶端預設找 /tmp/mysql.sock，但實際 Socket 位置不同。解決方法：

1. 找到實際 Socket 路徑：ps aux | grep mysqld 或查看 my.cnf。
2. 在 /usr/local/mysql/my.cnf（若不存在請新建）的 [client] 與 [mysqld] 區段加入：
   socket = /tmp/mysql.sock（或實際路徑）。
3. 重啟服務後再次測試連線。

5. 後續建議

• 將 /usr/local/mysql/bin 加入 PATH 環境變數，方便直接輸入 mysql、mysqldump 等指令。
• 執行 mysql_secure_installation 強化安全性（設定 root 密碼、移除匿名帳號、禁止遠端 root 登入等）。
• 若需多版本共存，建議改用 Homebrew 管理（brew install mysql@5.7 等）。