以下是 MySQL 8.0 全平台安装教程(涵盖 Windows/macOS/Linux),包含环境准备、安装步骤、配置优化及常见问题解决,附详细截图指引(文字等效描述):

- 系统要求:
- Windows:10/11 64 位(推荐),Server 2016+
- macOS:10.15+(Apple Silicon/M1 芯片需特殊适配)
- Linux:Ubuntu 20.04+/Debian 11+/CentOS 7+
- 硬件要求:至少 2GB 内存,500MB 存储空间
- 下载地址:MySQL 社区版(免费)
▶ 选择对应系统的 General Availability (GA) 版本(推荐 8.0.33+)
- 运行
.msi
安装包,选择 "Custom" 自定义安装:- 必选:MySQL Server(核心服务)、MySQL Shell(命令行工具)
- 可选:MySQL Workbench(图形化管理工具,推荐勾选)
- 配置类型选择 "Developer Default"(开发者模式,内存分配更合理)
- 设置 root 密码(需包含大小写字母 + 数字 + 符号,≥8 位),建议记录到密码管理器
- 确认服务名称(默认
MySQL80
),勾选 "Launch the MySQL Server at System Startup" 开机自启
- 右键 此电脑 > 属性 > 高级系统设置 > 环境变量
- 在 系统变量 的
Path
中添加:
C:\Program Files\MySQL\MySQL Server 8.0\bin
(根据安装路径调整) - 验证:Win+R 输入
cmd
,执行 mysql --version
,输出版本号即成功
- 以管理员身份打开命令提示符,执行:
mysql_secure_installation
- 按提示操作:
- 输入 root 密码
- 建议禁用匿名用户(
Y
) - 禁止 root 远程登录(
Y
,生产环境必选) - 删除测试数据库(
Y
) - 刷新权限(自动完成)
- 终端执行(需先安装 Homebrew):
- 启动服务(两种方式):
- 临时启动:
mysql.server start
- 开机自启:
brew services start mysql
- 初始化 root 密码:
mysql_secure_installation
▶ 首次运行会生成临时密码(查看日志:cat /usr/local/var/mysql/*.err
)
- 下载
.dmg
后双击,拖动 MySQL.prefPane
到系统偏好设置 - 启动服务,设置 root 密码(系统偏好设置内操作)
- 配置环境变量(终端执行):
echo 'export PATH="/usr/local/mysql/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc
- 安装 Rosetta 2:
softwareupdate --install-rosetta
- 强制使用 x86 版本:
arch -x86_64 brew install mysql
- 更新包列表并安装:
sudo apt update
sudo apt install mysql-server mysql-client
- 启动服务并设置开机自启:
sudo systemctl start mysql
sudo systemctl enable mysql
- 安全初始化:
sudo mysql_secure_installation
▶ 按提示设置密码,建议选择 Strong password validation(增强密码策略)
mysql -u root -p # 输入密码进入命令行 SELECT VERSION(); # 输出版本号(如 8.0.33) EXIT; # 退出
- 修改默认端口(避免冲突,如改为 3307):
编辑配置文件 my.cnf
(Windows 在 C:\ProgramData\MySQL\MySQL Server 8.0\my.ini
,macOS/Linux 在 /etc/mysql/my.cnf
):
- 调整时区(避免时间错位):
default-time-zone = '+8:00' # 东八区
- 启用慢查询日志(开发调试用):
slow_query_log = 1 slow_query_log_file = /var/log/mysql/mysql-slow.log long_query_time = 2 # 超过2秒的查询记录
▶ 修改后需重启 MySQL 服务生效
问题现象 | 解决方案 |
|
---|
服务启动失败(Windows) | 检查 C:\ProgramData\MySQL\MySQL Server 8.0\data 目录权限,确保非只读 |
|
root 密码忘记 | 1. 停止 MySQL 服务 2. 以安全模式启动:mysqld --skip-grant-tables 3. 执行 ALTER USER 'root'@'localhost' IDENTIFIED BY '新密码'; |
|
端口被占用 | 查看占用进程:`netstat -ano | findstr 3306<br>终止进程: taskkill /pid 进程号 /f(Windows)或 kill -9 进程号 `(Linux/macOS) |
连接被拒绝 | 确认防火墙开放 3306 端口(Windows 防火墙高级设置 > 入站规则新增端口) |
|
- 命令行验证:
mysql -u root -p # 输入密码后显示欢迎信息
- 图形化工具验证(推荐 MySQL Workbench):
- 新建连接:主机
localhost
,端口 3306
,用户 root
,输入密码 - 测试连接成功后,执行
SHOW DATABASES;
应显示系统库(如 information_schema
)
- 禁止 root 远程登录(生产环境必做):
UPDATE mysql.user SET Host = 'localhost' WHERE User = 'root'; FLUSH PRIVILEGES;
- 创建普通用户(开发使用):
CREATE USER 'dev'@'localhost' IDENTIFIED BY 'StrongPwd123!'; GRANT ALL PRIVILEGES ON test.* TO 'dev'@'localhost';
- 定期备份:
- 命令行备份:
mysqldump -u root -p 数据库名 > backup.sql
- 图形化工具:MySQL Workbench 的 Data Export 功能
通过以上步骤,您可在 10-15 分钟内完成 MySQL 安装与基础配置。如需集群部署或性能调优,可进一步参考官方文档或留言获取进阶教程。