Mac OS X 安裝 MySQL 完整指南：PKG 安裝、Startup Item、權限修復、升級遷移、別名與 PATH 設定

支援版本

• Mac OS X 10.2+ (Jaguar 及以上)，**不支援 10.1.x**。
• PKG 格式安裝包（.dmg 映像檔內）。

安裝前準備

• 關閉現有 MySQL：mysqladmin shutdown 或 MySQL Manager（Server 版）。

安裝流程

1. 雙擊 .dmg 掛載，雙擊 PKG 圖示啟動安裝程式。
2. 目標磁碟選擇對話框若出現 You cannot install this software on this disk. (null)：點 Go Back → 再次 Continue 選擇磁碟（已知 Installer Bug）。
3. 安裝至 /usr/local/mysql-VERSION，建立符號連結 /usr/local/mysql 指向新版本。
4. 若有舊 /usr/local/mysql 目錄，安裝程式自動改名為 /usr/local/mysql.bak。
5. 安裝完成自動執行 mysql_install_db 建立授權表。

佈局

• 二進制：/usr/local/mysql/bin
• 預設 Socket：/tmp/mysql.sock
• 需系統存在 mysql 用戶（10.2+ 預設有）。

Mac OS X Server 內建版本對照

• 官方 PKG 版本獨立於內建版本。
• 內建版本 < 4.0 需用 mysqld_safe 而非 safe_mysqld 啟動。

從 Marc Liyanage (entropy.ch) 套件升級

• 遵循其官網升級說明（二進制佈局相容）。
• 若從 3.23.x 或內建版本升級，**必須執行 mysql_fix_privilege_tables 升級授權表結構**（新增安全權限欄位）。

自動啟動：Startup Item

• 5.1+ 包含獨立 MySQLStartupItem.pkg，雙擊安裝**一次即可**，後續升級無需重裝。
• 安裝位置：/Library/StartupItems/MySQLCOM（4.1.2 前為 MySQL，與 Server 版衝突）。
• 寫入 /etc/hostconfig：MYSQLCOM=-YES-。改為 -NO- 可禁用自啟。
• Server 版內建用 MYSQL 變數，官方 Startup Item 會將其設為 -NO- 避免衝突，但不會關閉已運行實例，需手動關閉。

手動啟動/停止

# 有 Startup Item
sudo /Library/StartupItems/MySQLCOM/MySQLCOM start

# 無 Startup Item
cd /usr/local/mysql
sudo ./bin/mysqld_safe &
# Ctrl+Z → bg → 退出 shell

驗證連線

/usr/local/mysql/bin/mysql -u root -p
# 初始無密碼，登入後按 2.9 節設定密碼

Shell 別名與 PATH

# tcsh
alias mysql /usr/local/mysql/bin/mysql
alias mysqladmin /usr/local/mysql/bin/mysqladmin
setenv PATH ${PATH}:/usr/local/mysql/bin

# bash
alias mysql=/usr/local/mysql/bin/mysql
alias mysqladmin=/usr/local/mysql/bin/mysqladmin
export PATH=${PATH}:/usr/local/mysql/bin

升級後資料遷移

• 停止新舊服務。
• 複製舊 data 目錄內容至新 data 目錄。
• 啟動新服務驗證無誤後，刪除舊檔案與 /Library/Receipts/MySQL-VERSION.pkg 釋放空間。