macOS 安裝 MySQL 完整教學（Homebrew 版）

macOS 安裝 MySQL 完整教學（Homebrew 版）

macOS 上安裝 MySQL 有兩種主流方式：官方 DMG 安裝包與 Homebrew。DMG 安裝後常遇到 ERROR 2002 (HY000): Can't connect to local MySQL server through socket '/tmp/mysql.sock'，排查耗時。本文推薦使用 Homebrew，步驟更可控、易維護。

前置準備：安裝 Homebrew

在終端機執行官網提供的安裝指令：

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

安裝完成後執行 brew doctor 檢查環境。

安裝 MySQL

brew install mysql

等待編譯完成（視網速與機能約 5-15 分鐘）。

初始化資料目錄並啟動服務

若直接 mysql -u root -p 仍報 socket 錯誤，請依序執行：

unset TMPDIR
mysql_install_db --verbose --user=$(whoami) --basedir="$(brew --prefix mysql)" --datadir=/usr/local/var/mysql --tmpdir=/tmp
brew services start mysql

或手動啟動：mysql.server start

驗證登入

mysql -u root -p
# 輸入密碼（初次為空，直接 Enter）

設定開機自啟（可選）

mkdir -p ~/Library/LaunchAgents
cp /usr/local/Cellar/mysql/$(mysql --version | awk '{print $3}')/homebrew.mxcl.mysql.plist ~/Library/LaunchAgents/
launchctl load -w ~/Library/LaunchAgents/homebrew.mxcl.mysql.plist

注意：版本號請用 mysql --version 確認，勿硬編碼。

常見問題排查

• socket 路徑不一致：mysql_config --socket 查看實際路徑，若客戶端預設找 /tmp/mysql.sock，可建立軟連結 ln -s /usr/local/var/mysql/mysql.sock /tmp/mysql.sock。
• 權限問題：確保 /usr/local/var/mysql 屬於當前用戶 chown -R $(whoami) /usr/local/var/mysql。
• 多版本共存：Homebrew 預設只連結最新版，舊版用 brew services stop mysql 後 brew link --force mysql@5.7 切換。

卸載乾淨重裝

brew services stop mysql
brew uninstall mysql
rm -rf /usr/local/var/mysql
rm -rf /usr/local/etc/my.cnf
# 重新安裝

Homebrew 方式將配置檔集中在 /usr/local/etc/my.cnf，日誌在 /usr/local/var/log/mysql，便於統一管理與備份。