如何在 macOS 系统上安装 MySQL 8.0

297 阅读2分钟

在 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 上成功运行了!