给自己的 Windows 装 MySQL,这事儿听起来简单,但我在网上见过太多人在评论区里翻车。要么是服务装了根本起不来,要么是 root 密码弄丢了只能干瞪眼,更常见的是安装到一半报错,然后卡在某个英文弹窗里不知道点啥。这篇就专门讲 Windows 安装 MySQL,从最省事的图形化 MSI 安装,到手把手教你搞定 ZIP 免安装版,把初始化、配置文件、服务注册、客户端连接这些环节全讲透,顺便把大家踩过最多的坑都列出来。
1. 安装前先想清楚:版本与安装方式怎么选
1.1 先想清楚装哪个发行版:MySQL vs MariaDB
很多人没意识到,安装 MySQL 之前有个前置问题:你装的是 Oracle 官方的 MySQL,还是社区分支 MariaDB?虽然主流 Windows 教程说的是 MySQL,但 MariaDB 在不少企业里作为替代品也很常见,而且两者在 Windows 上的安装逻辑几乎一样。不过既然题目标题是“Windows 安装 MySQL”,下面主要围绕官方 MySQL 展开。
如果是个人学习、毕设、练手项目,直接用 MySQL 官方社区版(MySQL Community Server)就够了,它免费、文档全、遇到问题最容易搜到答案。如果是公司生产环境,通常会有 DBA 统一规划版本,不太可能让开发自己在 Windows 上随便装。所以对大部分读者来说,装官方社区版就是最稳的选择。
1.2 MySQL 8.0 还是 5.7:别凭习惯选版本
关于版本,给新手的第一条建议:新项目直接用 MySQL 8.0.x(或者更新的 8.x 小版本),别再用 5.7 了。我遇到过不少朋友,在网上找了一个两三年前的教程,下载的还是 5.7,结果装完发现很多 SQL 写法、认证插件跟新客户端不兼容,又要折腾升级。
8.0 相比 5.7 有几个明显变化,Windows 用户感知最强烈的两点:第一,默认认证插件改成了 caching_sha2_password,老版本的 Navicat、JDBC 驱动如果不更新,连接时会直接报 Authentication plugin 'caching_sha2_password' cannot be loaded;第二,8.0 的 my.ini 里很多默认参数更严格,比如字符集默认已经是 utf8mb4,排序规则也更合理。个人学习或者做小项目,没必要守着旧版本。
1.3 MSI 图形安装和 ZIP 免安装版,到底选哪个
官方给 Windows 用户提供了两种主流安装包,一个是 .msi 图形化安装向导,另一个是 .zip 免安装压缩包。很多第一次装 MySQL 的朋友,看到官网几个下载入口就懵了,这里直接把选择逻辑说明白:
- 如果你不想跟命令行打交道,希望一路 Next 完成安装,选 MSI Installer。它会自动处理服务注册、目录创建、环境变量配置,对新手最友好。
- 如果你需要快速部署、想自己完全掌控安装路径和配置、或者需要在多台机器上做一致性的离线上线部署,选 ZIP 免安装版。这种方式在服务器环境更常见,因为很多 Windows Server 上不方便跑图形安装向导。
- 还有个小众场景:你只是想临时跑一个 MySQL 做测试,用完就删,那用 ZIP 版更干净,因为它不写注册表,删除就是删文件夹。
我个人测试环境用 ZIP 版比较多,主要原因是可以同时放多个不同版本的 MySQL 目录,想用哪个配哪个,互不干扰。教程后面会重点讲这种方式。
1.4 安装前的检查清单
正式开始之前,按这个清单排查一遍,能省去后面大量麻烦:
- 确认 Windows 是 64 位系统,虽然 32 位也出过安装包,但 8.0 之后基本都是 64 位了。
- 磁盘剩余空间至少留 2GB,我见过有人 C 盘只剩几百 MB 就来装,结果初始化 MySQL 数据目录直接失败。
- 关闭杀毒软件和 Windows Defender 的实时保护,或者安装时选择信任。不是每次都冲突,但部分杀软会拦截 MySQL 的服务注册和端口监听,出现奇怪问题时先怀疑这个。
- 检查 3306 端口是否被占用:命令行执行
netstat -ano | findstr :3306,如果已经有进程在监听 3306,要么先停掉旧服务,要么后面配置改成 3307,不然服务根本起不来。 - 想好安装路径,切忌含有中文和空格。比如
C:\Program Files\MySQL这种默认路径也能用,但建议直接装到D:\MySQL\mysql-8.0.40或者C:\mysql-8.0.40,后面写配置、做备份都方便得多。
需要模型API调用? 免费领10W Token,多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. 图形化安装流程:一路 Next 前的关键节点
2.1 下载与启动安装程序
官网下载地址是 https://dev.mysql.com/downloads/mysql/,进入后可以看到 MySQL Community Server 的多个版本。页面上通常默认高亮最新版本,往下拉可以选择历史版本,但我建议直接下载当前最新 GA 版本,没必要追新也不必守旧。下载时选择 Windows (x86, 64-bit), MSI Installer,注意不要选成 ZIP Archive,除非你决定走手动部署路线。
下载完成后双击 .msi 文件。如果系统弹出 UAC 用户账户控制,点“是”就行。有些安装包体积比较大,首次安装时它还可能先去下载一些依赖组件,比如 Visual C++ Redistributable,这一步需要保持网络通畅,不要中途关掉。
2.2 Developer Default 与 Custom 选择的讲究
安装向导第一步会问安装类型,常见的几个选项是 Developer Default、Server only、Client only 和 Custom。我个人经验是,如果不是专门做 MySQL 全栈开发、不需要 MySQL Workbench 或其他组件,选 Server only 更轻量。但很多教程默认推荐 Developer Default,因为它在装 MySQL Server 的同时,还把 Workbench、Shell、Router、Excel 插件等一堆东西装上了,对学习确实方便,就是后台服务多、占资源。
如果不想让电脑里多出太多用不到的服务,我自己的建议是:学习用途选 Custom,把 MySQL Server、MySQL Shell 勾上,Workbench 看个人习惯。工作台在图形化操作时会用,但日常命令维护用命令行更多。选 `Server only
