Skip to content

MySQL 8.0 卸载 / 下载 / 安装 / 配置

卸载旧版本(重要)

安装 MySQL 8.0 之前,如果系统上已有旧版本,必须先彻底卸载。否则可能出现端口占用、版本冲突等问题。

Windows 卸载步骤

  1. 通过「控制面板 → 程序和功能」卸载 MySQL 相关程序
  2. 删除 MySQL 安装目录(默认 C:\Program Files\MySQL
  3. 删除数据目录(默认 C:\ProgramData\MySQL),注意备份数据
  4. 清理注册表(可选但建议):
    • HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\Eventlog\Application\MySQL
    • HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\MySQL

macOS 卸载步骤

bash
# 停止 MySQL 服务
sudo launchctl unload -w /Library/LaunchDaemons/com.oracle.oss.mysql.mysqld.plist

# 卸载安装包
sudo rm -rf /usr/local/mysql
sudo rm -rf /usr/local/mysql-8.0.xx          # 具体版本号
sudo rm -rf /Library/StartupItems/MySQL
sudo rm -rf /Library/Receipts/mysql-*
sudo rm -rf /Library/Receipts/MySQL-*

# 删除配置文件(注意备份)
sudo rm -rf /etc/my.cnf

Linux 卸载步骤

bash
# 停止服务
sudo systemctl stop mysqld
sudo systemctl disable mysqld

# 卸载
sudo yum remove mysql-community-server mysql-community-client mysql-community-libs
# 或
sudo apt remove mysql-server mysql-client mysql-common

下载 MySQL 8.0

下载地址:https://dev.mysql.com/downloads/mysql/

选择对应操作系统和架构:

  • Windows:mysql-installer-community-8.0.xx.msi
  • macOS:mysql-8.0.xx-macosxx-x86_64.dmg.tar.gz
  • Linux:源码包或 yum/apt 仓库

如果下载页面要求登录Oracle账号,点击下面的「No thanks, just start my download.」链接即可跳过。

Windows 安装(图形化安装向导)

安装步骤

  1. 双击 .msi 安装包,启动安装向导
  2. 选择 Custom 安装类型(推荐),方便选择安装路径
  3. 选择 MySQL Servers → MySQL Server 8.0.x → 64-bit
  4. 选择安装路径(建议不用默认的 C 盘,换一个磁盘)
  5. 点击 Execute 开始安装
  6. 安装完成后,进入 Product Configuration 页面

配置步骤

步骤一:类型和网络配置

保持默认即可(Development Computer / Server Machine / Dedicated Computer 根据你的用途选)。

MySQL 默认端口是 3306,如果没有特殊需求不要改。

步骤二:身份验证方式

选择 Use Strong Password Encryption(推荐)。

旧版兼容方式(Use Legacy Authentication)适合连接老版本的 JDBC 驱动,新项目一律选强加密。

步骤三:设置 root 密码

⚠️ 记住这个密码!
root 是 MySQL 的超级管理员账号,密码丢失很难找回。

建议密码格式:大写 + 小写 + 数字 + 特殊字符,长度 8 位以上。

步骤四:Windows 服务配置

勾选 Run MySQL Server as a Windows Service

服务名称默认 MySQL80,可以改成简短的名字如 MySQL

开机自启建议勾选。

步骤五:应用配置

点击 Execute 执行所有配置项。完成后点 Finish。

验证安装

打开 CMD 或 PowerShell:

bash
mysql -u root -p
# 输入密码后看到 mysql> 提示符说明安装成功

# 或者用以下命令验证
mysql --version
# mysql  Ver 8.0.xx for Win64 on x86_64 (MySQL Community Server)

macOS 安装

方式一:DMG 图形化安装(推荐新手)

  1. 下载 .dmg 文件,双击打开
  2. 双击 mysql-8.0.xx.pkg 开始安装
  3. 安装完成后,MySQL 服务会自动启动
  4. 打开「系统偏好设置 → MySQL」查看状态

方式二:Homebrew 安装(推荐开发者)

bash
# 安装
brew install mysql

# 启动服务
brew services start mysql

# 或者手动启动
mysql.server start

# 安全初始化(设置 root 密码)
mysql_secure_installation

方式三:压缩包安装

bash
# 解压到指定目录
sudo mv mysql-8.0.xx-macosxx-x86_64 /usr/local/mysql

# 初始化数据目录
cd /usr/local/mysql
sudo mysqld --initialize --user=mysql

# 记住临时密码(控制台会输出)
# A temporary password is generated for root@localhost: xxxxxxxx

# 启动 MySQL
sudo bin/mysqld_safe &

验证安装

bash
# 使用临时密码登录
mysql -u root -p

# 修改 root 密码
ALTER USER 'root'@'localhost' IDENTIFIED BY '你的新密码';

Linux 安装

方式一:yum 仓库安装(CentOS / RHEL / Rocky)

bash
# 下载 yum 仓库包
wget https://dev.mysql.com/get/mysql80-community-release-el7-7.noarch.rpm

# 安装仓库
sudo rpm -Uvh mysql80-community-release-el7-7.noarch.rpm

# 安装 MySQL
sudo yum install mysql-community-server

# 启动
sudo systemctl start mysqld
sudo systemctl enable mysqld

# 查看临时密码
sudo grep 'temporary password' /var/log/mysqld.log

# 安全初始化
sudo mysql_secure_installation

方式二:apt 仓库安装(Debian / Ubuntu)

bash
# 下载 apt 仓库包
wget https://dev.mysql.com/get/mysql-apt-config_0.8.xx-1_all.deb

# 安装仓库
sudo dpkg -i mysql-apt-config_0.8.xx-1_all.deb
# 交互式界面选择 MySQL 8.0

# 更新并安装
sudo apt update
sudo apt install mysql-server

# 启动
sudo systemctl start mysql
sudo systemctl enable mysql

MySQL 8.0 的关键配置

安装完成后,配置文件位于:

操作系统配置文件路径
WindowsC:\ProgramData\MySQL\MySQL Server 8.0\my.ini
macOS/usr/local/mysql/my.cnf/etc/my.cnf
Linux/etc/my.cnf/etc/mysql/my.cnf

核心配置项

ini
[mysqld]
# 端口
port=3306

# 数据存储目录(改成你想要的路径)
datadir=/var/lib/mysql

# 字符集(MySQL 8.0 默认 utf8mb4,一般不用改)
character-set-server=utf8mb4
collation-server=utf8mb4_unicode_ci

# 最大连接数
max_connections=200

# 错误日志
log-error=/var/log/mysql/error.log

# 慢查询日志(开启后记录超过 2 秒的查询)
slow_query_log=1
slow_query_log_file=/var/log/mysql/slow.log
long_query_time=2

[client]
default-character-set=utf8mb4

修改配置后重启

bash
# Windows
net stop MySQL80
net start MySQL80

# macOS / Linux
sudo systemctl restart mysqld

配置环境变量

Windows

  1. 右键「此电脑」→「属性」→「高级系统设置」→「环境变量」
  2. 在系统变量中找到 Path,双击编辑
  3. 添加 C:\Program Files\MySQL\MySQL Server 8.0\bin
  4. 确定保存后,新开 CMD 窗口生效

macOS / Linux

bash
# 在 ~/.bash_profile 或 ~/.zshrc 中添加
export PATH=$PATH:/usr/local/mysql/bin

# 生效
source ~/.zshrc

验证:mysql --version

常见问题

Q1:安装后无法启动,提示端口 3306 被占用

bash
# Windows:查看谁占用了 3306
netstat -ano | findstr 3306

# 结束进程或修改 my.ini 中的 port 为 3307

Q2:忘记 root 密码怎么办

bash
# 1. 停止 MySQL 服务
# 2. 以跳过权限验证的方式启动
mysqld --skip-grant-tables --shared-memory

# 3. 新开窗口,登录后修改密码
mysql -u root
FLUSH PRIVILEGES;
ALTER USER 'root'@'localhost' IDENTIFIED BY '新密码';

Q3:密码包含特殊字符无法登录

命令行登录时,特殊字符需要加引号:

bash
mysql -u root -p'P@ssw0rd!'

下一步

MySQL 装好了,下一步就是了解 MySQL 的目录结构,搞清楚数据、日志、配置都存在哪里。

基于 VitePress 构建