macOS 安裝 MySQL 完整指南：DMG 安裝、啟動與常見問題排查

下載與安裝

1. 官網下載：MySQL Community Server，選擇 macOS DMG Archive（含安裝包與啟動項）
2. 掛載 DMG，依序安裝：
   • mysql--macos-x86_64.pkg：核心程式
   • MySQLStartupItem.pkg：開機自動啟動
   • MySQL.prefPane：系統偏好設定面板（可視化控制啟停）

安裝路徑與關鍵檔案

• 安裝目錄：/usr/local/mysql-/，符號連結 /usr/local/mysql 指向最新版
• 執行檔：/usr/local/mysql/bin/
• 預設 Socket：/tmp/mysql.sock
• 資料目錄：/usr/local/mysql/data/

啟動與管理

方式一：啟動項（需安裝 MySQLStartupItem.pkg）

sudo /Library/StartupItems/MySQLCOM/MySQLCOM start
# 停止
sudo /Library/StartupItems/MySQLCOM/MySQLCOM stop

系統配置 /etc/hostconfig 中 MYSQLCOM=-YES- 控制開機自啟（改 -NO- 關閉）。

方式二：手動啟動

cd /usr/local/mysql
sudo ./bin/mysqld_safe &
# Ctrl+Z 暫停 → bg 後台運行 → exit 離開 shell

方式三：偏好設定面板

安裝 MySQL.prefPane 後，系統偏好設定 → MySQL 面板可視化啟停、設定開機自啟。

連線測試

/usr/local/mysql/bin/mysql -u root -p
# 預設 root 密碼為空，首次登入直接 Enter

常見問題與解決

1. Can't connect to local MySQL server through socket '/tmp/mysql.sock'

原因：PHP/客戶端預設尋找 /var/mysql/mysql.sock，但 MySQL 實際建立在 /tmp/mysql.sock。

解決：

• 修改 php.ini：mysql.default_socket = /tmp/mysql.sock
• 或建立軟連結：sudo mkdir -p /var/mysql && sudo ln -s /tmp/mysql.sock /var/mysql/mysql.sock
• 或在 my.cnf [client] 區段指定：socket = /tmp/mysql.sock

2. 修改 root 密碼

/usr/local/mysql/bin/mysqladmin -u root password 'new_password'

3. 將 mysql 指令加入 PATH

echo 'export PATH="/usr/local/mysql/bin:$PATH"' >> ~/.zshrc  # 或 ~/.bash_profile
source ~/.zshrc

小結

DMG 安裝是 macOS 上最省心的方式，包含核心程式、啟動項與 GUI 面板。關鍵注意 Socket 路徑差異與 PATH 設定，即可順利開發。