在 macOS 系统上安装 MySQL 8.0,推荐使用 Homebrew(macOS 的包管理工具)来安装,简单、高效、易于管理。
以下是详细的安装步骤(适用于 Intel 和 Apple Silicon 芯片的 Mac):
✅ 一、准备工作:安装 Homebrew(如果还没安装)
打开终端(Terminal),运行:
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
安装完成后,输入 brew --version 检查是否安装成功。
✅ 二、安装 MySQL 8.0
MySQL 8.0 在 Homebrew 中的包名为 mysql@8.0。
运行安装命令:
brew install mysql@8.0
⚠️ 注意:这不是
mysql(最新版),而是指定版本mysql@8.0。
✅ 三、配置环境变量(可选但推荐)
为了让终端能直接使用 mysql 命令,需要将 MySQL 添加到系统 PATH。
1. 编辑 shell 配置文件
如果你使用的是 zsh(macOS 默认):
echo 'export PATH="/opt/homebrew/opt/mysql@8.0/bin:$PATH"' >> ~/.zshrc
⚠️ 如果你是 Intel 芯片 Mac,路径可能是
/usr/local/opt/mysql@8.0/bin:$PATH
2. 重新加载配置
source ~/.zshrc
现在你可以在任意位置使用 mysql 命令了。
✅ 四、初始化 MySQL 数据目录
首次安装必须初始化数据库(生成系统表、root 用户等)。
1. 创建并清空数据目录
# 创建目录(如果不存在)
mkdir -p /opt/homebrew/var/mysql
# 清空内容(确保干净)
rm -rf /opt/homebrew/var/mysql/*
2. 设置权限
sudo chown -R $(whoami) /opt/homebrew/var/mysql
chmod 750 /opt/homebrew/var/mysql
3. 初始化数据库
/opt/homebrew/opt/mysql@8.0/bin/mysqld --initialize \
--user=$(whoami) \
--basedir=/opt/homebrew/opt/mysql@8.0 \
--datadir=/opt/homebrew/var/mysql
✅ 成功后你会看到类似输出:
[Note] A temporary password is generated for root@localhost: abc123-DEF456
👉 务必复制并保存这个临时密码,后面登录要用!
✅ 五、启动 MySQL 服务
brew services start mysql@8.0
这会让 MySQL 开机自启并在后台运行。
检查状态:
brew services list | grep mysql
正常输出应为:
mysql@8.0 started zhengshuangshuang ~/Library/LaunchAgents/homebrew.mxcl.mysql@8.0.plist
✅ 六、安全设置(设置 root 密码)
首次登录必须使用初始化时生成的临时密码。
mysql -u root -p
输入你保存的临时密码。
进入 MySQL 后,立即修改 root 密码(MySQL 8.0 强制要求):
ALTER USER 'root'@'localhost' IDENTIFIED BY '你的新密码';
🔐 建议密码包含大小写、数字、符号,如:
MySql@2025
退出:
exit;
✅ 七、连接测试
mysql -u root -p
输入新密码,如果能进入 mysql> 命令行,说明安装成功!
🔄 可选:卸载或切换版本
如果你想改用最新版 MySQL(推荐)
# 停止并卸载 8.0
brew services stop mysql@8.0
brew uninstall mysql@8.0
# 安装最新版
brew install mysql
brew services start mysql
mysql_secure_installation
❌ 常见问题解决
| 问题 | 解决方法 |
|---|---|
Data directory has files in it | 清空 /opt/homebrew/var/mysql/* |
Can't connect to local MySQL server | 检查服务是否启动:brew services start mysql@8.0 |
Command not found: mysql | 检查 PATH 是否配置正确 |
| 端口被占用 | lsof -i :3306 查看并杀掉进程 |
✅ 总结:安装流程图
1. 安装 Homebrew
2. brew install mysql@8.0
3. 配置 PATH
4. 初始化数据目录(--initialize)
5. 保存临时密码
6. brew services start mysql@8.0
7. mysql -u root -p 登录并改密码
完成以上步骤,MySQL 8.0 就在你的 Mac 上成功运行了!