推荐 macos 安装 mysql 的两种方式:图形化 DMG 包(适合初学者,需勾选 Legacy Password Encryption 并配置 PATH)和 Homebrew(适合开发者,自动管理服务与路径);关键要避坑环境变量、密码加密、端口 冲突等问题。

在 macOS 上安装 MySQL,推荐两种主流方式:图形化安装包(.dmg)和命令行 工具 Homebrew。前者适合初学者,操作直观;后者更轻量、易管理,适合开发者日常维护。关键不是选哪个,而是避开常见坑——比如环境变量漏配、密码加密方式不兼容、服务未自启或 端口 被占。
下载与安装:选对版本,注意加密方式
前往 MySQL 官网下载页,滚动到底部找到 MySQL Community Server,选择 macOS 14+ (x86-64 or ARM64) 对应的 DMG Archive(非 ZIP 或 TAR)。安装时一路“继续”,到设置 root 密码那步需特别注意:
- 务必勾选 Use Legacy Password Encryption(即 MySQL 5.x 加密方式),否则新版默认的 caching_sha2_password 会导致部分客户端(如老版本 navicat、某些 python 驱动)连接失败
- 密码建议用纯字母 + 数字组合,避免特殊字符(如 @ / $ 等),减少终端输入时转义问题
- 安装完成后,系统偏好设置底部会出现 MySQL 图标,绿色圆点表示服务已自动运行
配置环境变量:让终端认得 mysql 命令
安装包默认不配置 PATH,直接在终端输 mysql -u root -p 会提示 command not found。需手动添加路径:
- 打开终端,执行
sudo vim ~/.zshrc(macOS Catalina 及以后默认 shell 是 zsh) - 按 i 进入编辑模式,新增一行:
export PATH="/usr/local/mysql/bin:$PATH" - 按 ESC → 输入
:wq→ 回车保存退出 - 立即生效:
source ~/.zshrc - 验证:
echo $PATH应含/usr/local/mysql/bin;再运行mysql --version能显示版本即成功
启动、停止与基础连接
服务管理有两种方式,推荐优先用系统偏好设置图形界面,更稳妥:
- 点击屏幕左上角 apple 图标 → 系统设置 → 滚动到底部点 MySQL → 开关控制启停
- 命令行方式(需确保 PATH 已配好):
启动:sudo /usr/local/mysql/support-files/mysql.server start
停止:sudo /usr/local/mysql/support-files/mysql.server stop - 首次连接:
mysql -u root -p,回车后输入安装时设的密码 - 若报错
access denied for user 'root'@'localhost',大概率是密码输错,或安装时没记牢——可临时用sudo /usr/local/mysql/bin/mysqld_safe --skip-grant-tables &启动跳过权限验证重置
可选但实用:Homebrew 方式(适合开发者)
如果你已装 Homebrew(没装就先运行 /bin/bash -c "$(curl -fssl https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"),安装更简洁:
- 安装:
brew install mysql(默认最新稳定版) - 启动服务:
brew services start mysql(开机自启也支持) - 连接:
mysql -u root(Homebrew 安装的 root 默认无密码,首次登录后建议立即执行mysql_secure_installation设置密码并加固) - 卸载干净:
brew services stop mysql && brew uninstall mysql && rm -rf /usr/local/var/mysql