- Windows 本地安装 MySQL 8.0 详细指南(含密码修改与环境配置)
- 一、MySQL 简要概述
- 主要特性:
- 二、安装准备
- 系统要求(Windows)
- 三、下载 MySQL Installer(仅适用于 MySQL 8.0 及以下)
- 选择安装包类型:
- 四、安装步骤(图文精简版)
- 1. 运行安装程序
- 2. 选择安装类型
- 3. 安装依赖项
- 4. 配置 MySQL 服务器(关键步骤)
- 配置流程详解:
- 五、验证安装
- 方法 1:使用 MySQL Workbench(推荐)
- 方法 2:命令行测试
- 1. 添加环境变量(让
mysql命令全局可用) - 2. 测试命令行连接
- 六、常用操作:修改 root 密码
- 方法 1:已能登录时修改密码
- 方法 2:忘记密码时重置(安全模式)
- 步骤:
- 七、卸载 MySQL(如有需要)
- 八、常见问题 FAQ
- 九、后续建议
- 总结
Windows 本地安装 MySQL 8.0 详细指南(含密码修改与环境配置)
适用对象:Web 开发者(Flask、Django 等)、初学者、本地环境搭建者
支持最新版本说明:MySQL 8.0 是最后一个支持 MySQL Installer 的版本。从 MySQL 8.1 起,官方不再提供 Installer,需使用 MSI 或 ZIP 包配合 MySQL Configurator 安装配置。
一、MySQL 简要概述
MySQL 是一个开源的关系型数据库管理系统(RDBMS),由 Oracle 公司维护,广泛应用于 Web 应用后端数据存储。它以高性能、高可靠性和易用性著称,是 LAMP/LEMP 架构中的核心组件之一。
主要特性:
- 开源免费(Community Edition)
- 支持标准 SQL
- 支持事务(InnoDB 引擎)、外键、触发器、视图
- 高性能读写,适用于中小规模应用
- 与 Python(Django、Flask)、PHP、Java 等主流语言无缝集成
- 提供图形化管理工具(如 MySQL Workbench)
提示:MySQL 8.0 引入了窗口函数、角色管理、JSON 增强等功能,是目前最稳定且功能丰富的长期支持版本之一。
二、安装准备
系统要求(Windows)
- Windows 7 SP1 或更高版本(推荐 Windows 10/11)
- .NET Framework 4.5.2 或以上
- Visual C++ Redistributable(安装器会自动处理)
三、下载 MySQL Installer(仅适用于 MySQL 8.0 及以下)
🔗 官方下载地址:https://dev.mysql.com/downloads/installer/
⚠️ 重要提示:
- MySQL 8.1 及以上版本不再支持 MySQL Installer
- 推荐使用 MySQL 8.0.x 作为本地开发版本,便于通过图形化向导安装和配置
- 8.1+ 需使用独立的 MSI 安装包,并通过 MySQL Configurator 进行配置
选择安装包类型:
| 类型 | 文件名 | 适用场景 |
|---|---|---|
| 在线安装包 | mysql-installer-web-community |
文件小(~20MB),安装时联网下载组件 |
| 离线安装包 | mysql-installer-community |
文件大(~400MB),无需网络,适合无网环境 |
MySQL Installer 本身为 32 位程序,但可安装 32 位和 64 位 MySQL 组件。
四、安装步骤(图文精简版)
1. 运行安装程序
- 双击
.exe文件,以管理员身份运行 - 接受许可协议,点击 Next
2. 选择安装类型
推荐选择:
Developer Default(开发者默认)
- 包含:MySQL Server + MySQL Workbench + 连接器(Connector/C++, ODBC 等)
- 适合大多数开发场景
其他选项:
- Server only:仅安装 MySQL 服务
- Custom:自定义组件(高级用户)
点击 Next → Installer 自动下载所需组件(在线安装需等待)
3. 安装依赖项
Installer 会自动安装必要的运行库(如 Visual C++),按提示完成即可。
4. 配置 MySQL 服务器(关键步骤)
点击 Next 进入配置向导,选择要配置的 MySQL Server 实例 → 点击 Execute
配置流程详解:
| 步骤 | 操作说明 |
|---|---|
| Type and Networking | 选择:Developer Machine(开发机)端口:默认 3306(可修改,建议保持)TCP/IP 连接启用 ✔️ |
| Authentication Method | 选择:Use Legacy Authentication Method(推荐) 原因:兼容旧版客户端和部分 ORM 框架(如 Django) |
| Accounts and Roles | 设置 root 用户密码(务必记住!) 可添加普通用户(如 dev) |
| Windows Service | 勾选:Install as Windows Service服务名:默认 MySQL80开机自启 ✔️ |
| Apply Configuration | 点击 Execute 应用配置,等待完成 |
✅ 出现绿色对勾表示配置成功!
五、验证安装
方法 1:使用 MySQL Workbench(推荐)
- 开始菜单 → 打开 MySQL Workbench
- 点击
Local Instance MySQL80 - 输入 root 密码 → 成功连接即表示安装成功
方法 2:命令行测试
1. 添加环境变量(让 mysql 命令全局可用)
- 打开“此电脑” → 右键 → “属性” → “高级系统设置”
- 点击“环境变量”
- 在“系统变量”中找到
Path→ 编辑 → 新建 - 添加 MySQL 的
bin目录路径,例如:C:\Program Files\MySQL\MySQL Server 8.0\bin - 保存并关闭
2. 测试命令行连接
mysql -u root -p输入密码后,若进入 mysql> 提示符,则安装成功。
六、常用操作:修改 root 密码
场景:忘记密码 / 需要重置 / 安全加固
方法 1:已能登录时修改密码
ALTER USER 'root'@'localhost' IDENTIFIED BY '你的新密码';
FLUSH PRIVILEGES;方法 2:忘记密码时重置(安全模式)
步骤:
停止 MySQL 服务:
net stop MySQL80创建跳过权限检查的启动文件:
新建一个文本文件mysql-init.txt,内容如下:ALTER USER 'root'@'localhost' IDENTIFIED BY 'new_password';保存路径如:
C:\mysql-init.txt启动 MySQL 并加载该脚本:
"C:\Program Files\MySQL\MySQL Server 8.0\bin\mysqld.exe" --defaults-file="C:\ProgramData\MySQL\MySQL Server 8.0\my.ini" --init-file=C:\mysql-init.txt --console⚠️ 注意路径根据实际安装位置调整
关闭服务后正常重启:
net stop MySQL80 net start MySQL80使用新密码登录:
mysql -u root -p
七、卸载 MySQL(如有需要)
- 控制面板 → 卸载程序 → 卸载 MySQL Installer 和相关组件
- 删除残留目录:
C:\Program Files\MySQL\C:\ProgramData\MySQL\(隐藏文件夹,需显示隐藏项)
- 清理注册表(可选,谨慎操作):
- 使用注册表编辑器删除
HKEY_LOCAL_MACHINE\SOFTWARE\MySQL AB
- 使用注册表编辑器删除
八、常见问题 FAQ
| 问题 | 解决方案 |
|---|---|
mysql不是内部或外部命令 |
未添加 bin 目录到环境变量,请检查路径是否正确 |
| 3306 端口被占用 | 使用 `netstat -ano |
| 连接被拒绝 | 检查服务是否启动:services.msc → 查找 MySQL80 → 启动 |
| Authentication plugin ‘caching_sha2_password’ cannot be loaded | 使用“传统认证方式”安装,或在连接字符串中添加 ?auth_plugin=mysql_native_password |
九、后续建议
- 使用 MySQL Workbench 管理数据库结构和数据
- 开发中建议创建非 root 用户,避免误操作
- 备份重要数据:使用 Workbench 的 Data Export 功能
- 生产环境请启用防火墙、限制远程访问、定期更新
总结
| 项目 | 推荐配置 |
|---|---|
| 版本 | MySQL 8.0.x(最后支持 Installer 的版本) |
| 安装方式 | MySQL Installer(Web 或离线包) |
| 认证方式 | Legacy Authentication(兼容性更好) |
| root 密码 | 强密码 + 安全保存 |
| 工具 | MySQL Workbench(图形化管理) |
| 环境变量 | 添加 bin 目录到 Path |
现在你已经拥有了一个稳定运行的本地 MySQL 数据库!
可立即用于 Django、Flask、Node.js 等项目的开发与调试。
🌐 官方文档参考:https://dev.mysql.com/doc/
最后编辑:admin 更新时间:2025-10-20 17:11