如何在macOS上安装mysql_mysql Mac安装配置指南

来源:这里教程网 时间:2026-02-28 20:30:59 作者:

在 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

相关推荐