macOS 安裝 MySQL 5.0.15 完整指南（PKG 套件版）

適用環境與前置條件

• 作業系統：Mac OS X 10.2.x (Jaguar) 及以上版本
• 不支援 10.1.x 等舊版本
• 安裝檔為 .dmg 磁碟映像檔，雙擊掛載後即可看到 PKG 安裝包

安裝前準備

重要： 安裝前務必關閉所有正在運行的 MySQL 伺服器實例：

• Mac OS X Server：使用 MySQL Manager Application
• 命令列：執行 mysqladmin shutdown

安裝步驟

1. 雙擊 PKG 圖示啟動 Mac OS X Package Installer
2. 依嚮導指引完成安裝

常見安裝錯誤與解決

若在選擇目標磁碟畫面出現 You cannot install this software on this disk. (null)，此為 Apple 安裝程式已知 Bug。解決方法：點擊 Go Back 返回上一頁，再點 Continue 重新進入磁碟選擇畫面即可正常選擇。

安裝路徑與佈局

• 主程式安裝於 /usr/local/mysql-<版本號>
• 自動建立符號連結 /usr/local/mysql 指向最新版本
• 若 /usr/local/mysql 已存在，會先重命名為 /usr/local/mysql.bak
• 安裝後自動執行 mysql_install_db 建立授權表
• 二進制檔位於 /usr/local/mysql/bin
• 預設 Socket 檔：/tmp/mysql.sock

系統帳號需求

需存在名為 mysql 的系統使用者帳號（Mac OS X 10.2+ 預設已建立）。

Mac OS X Server 內建 MySQL 版本對照

本文僅涵蓋官方 MySQL PKG 安裝。內建版本請參閱 Apple 官方說明（Help Viewer → Mac OS X Server → 搜尋 "MySQL" → "Installing MySQL"）。

啟動 MySQL 服務

方式一：安裝 Startup Item（推薦，僅需安裝一次）

• MySQL 5.0 另提供 MySQLStartupItem.pkg，雙擊安裝
• 安裝路徑：/Library/StartupItems/MySQLCOM
• 會在 /etc/hostconfig 加入 MYSQLCOM=-YES-
• 停用自動啟動：將該值改為 MYSQLCOM=-NO-

啟動命令：

shell> sudo /Library/StartupItems/MySQLCOM/MySQLCOM start

方式二：手動啟動

shell> cd /usr/local/mysql
shell> sudo ./bin/mysqld_safe
(輸入密碼)
(按 Control-Z)
shell> bg
(按 Control-D 或輸入 exit 離開)

驗證連線與後續設定

• 測試連線：/usr/local/mysql/bin/mysql
• 注意： 初始授權表帳號皆無密碼，請盡快設定
• 建議加入別名或將 /usr/local/mysql/bin 加入 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

升級與資料遷移注意事項

• 新版 PKG 不會移除舊版目錄，需手動複製舊資料目錄內容至新資料目錄（確保雙方服務皆停止）
• 遷移完成並驗證新服務正常後，可刪除舊安裝檔案與 /Library/Receipts/mysql-<版本>.pkg 釋放空間
• 從 Marc Liyanage 套件或 Server 版升級時，需執行權限表轉換（新增安全權限欄位）