说实话MySQL的安装教程网上一搜一大把但很多初学者还是会在第一步就卡住——下载错了版本、装到一半报错、装完之后连不上、密码搞丢了……我见过太多人在交流群里对着安装界面截图求助来来回回折腾好几天。这篇文章就是冲着照着做一定能装好去的我把整个安装过程从下载到验证翻了个底朝天把每一步为什么要这么做也讲清楚保证你跟着走完一遍手里的MySQL是能真正跑起来的。写这篇教程之前我先说个前提我默认你用的是Windows系统MySQL版本以8.0系列为主。2020年这个时间点MySQL 8.0已经发布两年多了稳定性和社区生态都很成熟是当时最适合生产环境和学习使用的版本。同时我也会把5.7版本的选择方法带出来毕竟还有些老项目依赖5.7后面我会专门讲这两者的差异。1. 安装前先想清楚版本、安装方式、字符集这三件事很多教程上来就让你点下一步、下一步结果装到一半发现不对劲还得卸载重来。我建议你先花十分钟把下面三个问题想明白磨刀不误砍柴工。1.1 MySQL 8.0和5.7到底选哪个这是我在各种群里被问得最多的问题。直接给结论如果你是自己学习、写作业、做小项目无脑选MySQL 8.0。它是当前和未来的主流官方对5.7的维护在2023年后基本进入延长期新特性、性能优化、安全补丁都在8.0上。你现在学5.7等面试找工作时还得重新适应8.0的差异。如果你是在公司维护老项目、接手旧系统那大概率已经固定了5.7或者其他版本这种情况跟着项目走别自己瞎升级。如果是要部署到生产环境新项目直接8.0老系统升级之前务必做好兼容性评估尤其是连接驱动和ORM框架版本。8.0和5.7最大的几个区别我帮你梳理一下对比项MySQL 5.7MySQL 8.0默认字符集latin1需手动改成utf8mb4utf8mb4认证插件mysql_native_passwordcaching_sha2_password窗口函数不支持支持隐藏索引不支持支持通用表表达式CTE不支持支持性能表现稳定高并发下更优这里面最直接影响日常使用的是认证插件的区别。8.0默认的caching_sha2_password加密方式更安全但如果你用的客户端工具版本太老比如旧版Navicat或者老版本JDBC驱动可能连不上。这也是我下面要讲的认证方式选择这个坑的来源。1.2 MSI安装版和ZIP免安装版怎么选Windows下装MySQL主流就是两条路MSI安装包和ZIP解压包。很多教程会告诉你推荐MSI版省事但我觉得要分情况。MSI安装版适合大多数新手有图形界面一步步点击自动帮你配置服务、环境变量安装过程中有验证环节出错信息也比较友好。整个过程像装QQ一样傻瓜式。缺点是你不太清楚它到底在背后做了什么出了问题排查起来比较被动。ZIP免安装版适合进阶用户和喜欢折腾的人下载压缩包解压自己写my.ini配置手动初始化、注册Windows服务。全程都是自己控制的配置文件在哪、data目录在哪、服务名叫什么一清二楚。以后想换版本、多实例部署都是加分项。我的建议是如果你是第一次接触MySQL先用MSI版装成功后面想深入理解了再装一个ZIP版折腾。不要一上来就挑战ZIP版否则容易在初始化那一步就被临时密码劝退。1.3 字符集选择决定了你后面会不会乱码字符集这个问题坑了不知道多少人。你以为装好了结果往表里存中文查出来全是问号然后开始怀疑人生。MySQL 8.0默认字符集就是utf8mb4这个特别好基本不用管。但如果你装的是5.7版本默认是latin1那就必须手动改。utf8mb4是utf8的超集能存emoji表情能完美支持中文现在已经是事实标准了。我在后面讲my.ini配置时会把相关配置项写出来到时候直接抄就行。顺便说一句连接层的字符集和数据库层的字符集是两回事。你数据库设了utf8mb4但客户端连接时用的还是latin1照样乱码。所以后面用命令行连接时要执行SET NAMES utf8mb4;或者连接工具里指定编码这一点在后面验证环节会提到。2. 下载安装包入口、链接和点击顺序下载这一步看似简单实际上翻车率极高。主要原因是MySQL官网的页面结构有点反人类初次去的人很容易迷路或者干脆下错版本。2.1 官网入口和社区版的定位打开浏览器输入MySQL官网地址但不要直接点页面上的Downloads也不要被网页顶部的各种产品宣传分散注意力。你要找的是MySQL Community Edition也就是社区版它是免费开源的。教程里说的MySQL默认都是指社区版。注意别点到MySQL Enterprise、MySQL Cluster CGE那些商业产品那些是要收费授权的虽然也可以下载试用但不是我们要的东西。页面导航一般是Products - MySQL - MySQL Community Server或者你直接在Downloads页面里找到MySQL Community (GPL) Downloads的入口点进去。GPL是开源许可证用这个词儿的版本就是社区版无疑。2.2 选择操作系统和安装包类型进入MySQL Community Server的下载页面后能看到一个大表格首先要选操作系统。Windows对应的选项是Microsoft Windows选完后下面会出现两个安装包Windows (x86, 32-bit), ZIP Archive32位系统的ZIP包现在基本用不上了Windows (x86, 64-bit), ZIP Archive64位ZIP免安装版Windows (x86, 32-bit), MSI Installer32位MSI安装版Windows (x86, 64-bit), MSI Installer64位MSI安装版Windows (x86, 64-bit), 7z Archive7z压缩格式的免安装版选择标准很简单64位系统就下载64位的MSI Installer或ZIP Archive。怎么看自己的系统位数右键此电脑-属性里面写得很清楚。2020年这个节点还用32位系统的电脑真的非常罕见了但保险起见还是确认一下。2.3 需要加注的登录跳过和镜像站选择很多人走到这一步发现页面提示要登录MySQL账号才能下载然后就跑去注册了。其实完全不用那是Oracle账号体系的登录墙下载安装包根本不需要。你注意看一下登录框下面有个No thanks, just start my download.的链接或者类似No thanks, begin download的提示点它就能直接下载了。如果是国内网络访问官网速度不太理想下载中途断了让人很崩溃。这时候可以换个思路到国内一些镜像站下载比如部分高校或云厂商的镜像仓库。搜索MySQL 镜像或者直接找mysql-8.0.xx-winx64.zip这类文件名就行。这里不做具体推广你自己找口碑好的镜像即可注意校验文件的MD5值。我用镜像下载时就吃过亏文件不完整导致安装时报错后来养成习惯下载完先比对一下校验值再动手。3. MSI安装版全流程每个勾选框的选择理由MSI安装版是绝大多数人的选择我在这里把每一步展开讲透特别是那些很容易被忽略的勾选框。3.1 安装类型选择和组件定制双击下载好的.msi文件首先看到的是MySQL Installer的欢迎界面。选Custom模式这个很关键。Developer Default会装一大堆你不一定用得上的组件包括Visual Studio插件、MySQL for Excel之类的体积大、耗时长、还容易因为缺少系统环境而报错。选Custom你可以只选自己需要的组件。在Custom模式下左侧是可选组件列表你需要展开MySQL Servers这个树形结构选择对应版本的MySQL Server 8.0.xx - X64然后点击中间的向右箭头把它加到右侧待安装列表里。如果你想用可视化工具可以在Application下面勾选MySQL Workbench这个工具后面验证连接时会用到建议装上。组件选好后下面有个Advanced Options入口点开能设置数据存放目录。默认Data Directory会在ProgramData文件夹下我建议改到一个非系统盘且路径中不包含空格的目录比如D:\MySQL\Data。这样以后备份、清理、重装系统时不至于丢数据而且ProgramData目录默认隐藏新手找起来很费劲。3.2 配置阶段的几个关键决策点安装完成后会自动进入配置向导这里有四个核心选项我拆开讲。High Availability选Standalone MySQL Server / Classic MySQL Replication这是我们日常开发用的单机模式。另一个是InnoDB Cluster那是做高可用集群时才用的初学者完全不用碰。Type and NetworkingConfig Type选Development Computer内存占用相对合理。端口号默认3306除非你的3306端口被其他程序占用否则不要改。注意勾选Show Advanced Configuration这个选项这样才能看到下面要讲的认证方式设置。Authentication Method这是初学者最容易踩坑的地方。8.0默认的是Use Strong Password Encryption for Authentication (RECOMMENDED)对应caching_sha2_password插件下面那个Use Legacy Authentication对应老旧的mysql_native_password插件。如果你用的客户端工具比较新比如新版MySQL Workbench、新版Navicat、新版JDBC驱动选推荐项没问题。但如果你用的是几年前的老驱动、老工具请先选Legacy。我的做法是自己学习用推荐项公司里技术栈比较老就选Legacy。记住这里的选择后面忘记密码或连不上时要回来检查这个配置。Root Password设置root用户的密码。这个密码一定要记牢建议用密码管理器保存下来。MySQL对密码强度有默认校验太简单的密码会过不去比如纯数字6位有时候就报错。建议设置成大小写字母数字特殊符号的组合至少8位。下方可以添加其他用户这一步可以先跳过。3.3 Windows Service配置和运行时检查接下来是Windows Service配置。勾选Configure MySQL Server as a Windows Service服务名默认是MySQL80不用改。下面的Start the MySQL Server at System Startup建议勾上这样开机自动启动省得每次手动开服务。如果你不喜欢开机自启可以关掉这个选项但那就得保证用MySQL前先手动启动服务。Run Windows Service as...选项默认是Standard System Account保持默认即可新手不要动这个。如果你喜欢折腾也可以指定一个Windows系统用户但这容易引入权限问题得不偿失。还要注意服务名后面用命令行启停服务、排查问题都靠这个服务名。全部配置完成后点击Execute安装程序会自动准备配置、初始化数据库、应用配置、启动服务最后显示Complete的绿色标识。这中间如果某个环节卡住看下面的日志输出。绝大多数情况下配置失败都和数据目录路径权限有关检查一下你之前设置的Data Directory是否存在、是否可写。配置成功后就全部完成了。安装完成后默认会启动MySQL Workbench用root和刚才设置的密码能连上说明你的MSI版安装就已经大功告成。4. ZIP免安装版的初始化与Service注册附my.ini我承认我第一次真正理解MySQL的目录结构和启动流程是在用了ZIP免安装版之后。MSI版像是一键完成的黑盒ZIP版则是把每一步都摊在你面前。所以这里专门开一章讲ZIP版不是为了折腾而折腾是为了让你以后碰到问题不会两眼一抹黑。4.1 解压目录规划和my.ini配置文件从官网下载ZIP包后找一个放软件的目录比如D:\mysql-8.0.34-winx64解压进去。注意路径中尽量不要出现中文和空格否则后面配置容易出现灵异问题。解压后你会看到bin、docs、include、lib、share这几个目录这时候还没有data目录需要你自己初始化。在MySQL的根目录下创建一个my.ini文件。如果直接用记事本新建文本然后改扩展名记得把编码保存为ANSI或UTF-8不带BOM否则可能因为字符集问题导致配置不识别。这是一个经常出现的坑很多人配置文件写对了就是启动报错最后发现是编码问题。下面是一份我日常使用的配置注释直接写在里面了[mysqld] # 端口号一般保持3306 port3306 # MySQL安装根目录改成你自己的实际路径 basedirD:/mysql-8.0.34-winx64 # 数据存放目录路径不存在会自动创建 datadirD:/mysql-8.0.34-winx64/data # 默认存储引擎 default-storage-engineINNODB # 默认字符集 character-set-serverutf8mb4 # 默认排序规则utf8mb4_0900_ai_ci是8.0默认规则 collation-serverutf8mb4_0900_ai_ci # 连接层字符集 default-character-setutf8mb4 [client] default-character-setutf8mb4 [mysql] default-character-setutf8mb4把basedir和datadir换成你自己的实际路径保存关闭。配置准备好了接下来就进入命令行环节。4.2 初始化、安装服务和启动的完整命令链打开命令行CMD但注意一定要以管理员身份运行否则后面注册服务的时候会提示权限不足。先进入MySQL的bin目录cd /d D:\mysql-8.0.34-winx64\bin然后执行初始化命令。这一步会把数据目录、系统表、root账号全部创建好mysqld --initialize --console--initialize表示初始化--console表示把初始化日志输出到当前控制台。执行后会看到一段日志里面最关键的是最后一行A temporary password is generated for rootlocalhost: xxxxxxxx这个临时密码一定要复制保存下来下一步登录要用。如果你没开--console日志会写到数据目录下的错误日志文件里找起来麻烦。初始化完成后注册Windows服务mysqld --install MySQL80这里的MySQL80是服务名可以自定义但保持和MSI默认的服务名一致更方便。提示Service successfully installed就说明注册成功。接着启动服务net start MySQL80如果一切顺利会提示服务启动成功。如果启动失败先别慌去data目录下找.err结尾的错误日志文件打开看最后几行基本能找到原因。90%的情况是my.ini配置路径写错了或者端口被占用。这个排查思路我后面还会细讲。5. 装完别急着用环境变量、防火墙和远程访问很多人在安装成功后直接在MySQL的bin目录里敲命令感觉没什么问题。但一旦换个目录mysql -uroot -p就提示不是内部或外部命令。这就是没配置环境变量造成的。5.1 PATH环境变量的配置方法右键此电脑-属性-高级系统设置-环境变量。在系统变量中找到Path双击打开点新建把MySQL的bin目录路径填进去比如D:\mysql-8.0.34-winx64\bin点确定保存。这样配置完成后重新打开一个CMD窗口直接输入mysql --version能看到版本号输出就说明环境变量生效了。这一步除了方便日常命令行操作还有一个好处是很多开发工具比如Python的pymysql、Java的JDBC在调用MySQL时会自动从环境变量里找相关路径不配置好会有各种连锁问题。5.2 登录root和修改初始密码环境变量配好后登录mysqlmysql -uroot -p提示输入密码把之前记录的临时密码粘贴进去。注意MySQL命令行中粘贴密码是看不见任何字符的不是没输入上不要怀疑自己。登录成功后会进入mysql提示符。第一件事改密码临时密码又长又难记肯定不能一直用ALTER USER rootlocalhost IDENTIFIED BY 你的新密码;MySQL 8.0的密码规则默认要求至少8位包含大小写字母、数字和特殊符号。如果想放宽限制或者你实在不想要这么复杂的密码可以修改密码校验策略但不建议在生产环境这么做学习环境随意。这里再提醒一次如果之前MSI安装时你选了Legacy Authentication那新建用户时可能还得显式指定认证插件。比如CREATE USER test% IDENTIFIED WITH mysql_native_password BY test123;%表示允许任意主机连接localhost只允许本机连接。这个区别很关键下面还会用到。5.3 防火墙放行3306端口和远程访问设置默认情况下MySQL只允许本机连接rootlocalhost。但实际开发中你很可能需要从其他电脑连过来比如用工作电脑连一台开发服务器上的MySQL。这时候要处理两件事MySQL端的用户权限以及Windows防火墙的端口放行。MySQL端先创建一个允许远程连接的用户并授权CREATE USER dev% IDENTIFIED BY dev123456; GRANT ALL PRIVILEGES ON *.* TO dev%; FLUSH PRIVILEGES;FLUSH PRIVILEGES让权限立刻生效。这样任何主机用dev账号都能访问你的MySQL了如果有更高的安全要求可以把%换成特定的IP。Windows防火墙的放行很简单打开控制面板-Windows Defender防火墙-高级设置-入站规则-新建规则选择端口协议选TCP端口填3306操作选允许连接然后一直下一步。如果你的电脑装了第三方安全软件记得也去它的防火墙设置里放行3306这类软件有时候管得比系统还严。6. 用Workbench和命令行双重验证安装是否成功装完不等于装好了验证才是关键。我习惯用两种方式验证命令行验证基础功能Workbench验证图形界面连接。这样能确认数据库服务、认证方式、网络通信都是通的。6.1 命令行验证版本、数据库列表和字符集新开一个命令行窗口执行mysql -uroot -p输入密码登录后依次执行下面几条SQL-- 查看当前版本 SELECT VERSION(); -- 查看现有数据库 SHOW DATABASES; -- 查看当前会话的字符集设置 SHOW VARIABLES LIKE character_set%;正常情况下你的客户端字符集应该显示为utf8mb4。如果显示latin1说明my.ini或连接参数没生效。顺手验证一下中文存储是否正常这是最直观的测试CREATE DATABASE testdb DEFAULT CHARACTER SET utf8mb4; USE testdb; CREATE TABLE test_table (id INT PRIMARY KEY, name VARCHAR(50)); INSERT INTO test_table VALUES (1, 中文测试); SELECT * FROM test_table;如果SELECT能正常显示中文而不是???说明字符集配置完全没问题。6.2 Workbench连接的本机与远程测试打开MySQL Workbench点击主界面的加号添加连接。Hostname填127.0.0.1或localhost都行但很多人不知道这两者是有细微区别的。在MySQL里localhost通常走的是socket连接Windows下也可能走共享内存方式而127.0.0.1走的是TCP/IP连接。如果你之前测试远程连接时一切配置都正确但不通试着用127.0.0.1而不是localhost去连。输入用户和密码点Test Connection显示Successfully made the connection就说明本机没问题。接着测试远程连接在另一台电脑上打开Workbench或者任意客户端工具Hostname填目标服务器的IP地址用户名填之前创建的dev账号端口填3306点击连接。如果通了说明防火墙、远程授权、账号认证全都凑效了。如果连不上参考下面一章的排查思路。7. 安装过程中的高发翻车现场与排查链路我终于写到整个教程里最实用的部分了。下面这些翻车场景我接触过的用户里几乎每三个人就遇到一个而且特征高度相似。我把排查思路完整写出来你可以按顺序一步步走而不是瞎猜。7.1 服务启动失败先看日志别反复重启现象net start MySQL80提示服务启动失败或服务启动后又停止了。很多人这时候会反复尝试启动或者在服务管理器里右键启动反复点结果问题一点没解决。正确的排查顺序是先用命令找到MySQL的错误日志位置。默认情况下日志在数据目录下也就是my.ini里datadir配置的那个目录文件名叫[你的主机名].err。打开这个文件看最后50行常见的错误有两类[ERROR] [MY-010273] Cant create/write to file /tmp/xxx这是目录权限或路径问题检查basedir和datadir路径是否存在。[ERROR] [MY-012681] Plugin InnoDB init function returned error通常是数据目录里的文件损坏了要检查是不是之前初始化时强制中断。这里有一个经验不要一看到日志报错就直接把data目录删了重新初始化先仔细看日志。很多情况下只是路径里的反斜杠写错了Windows路径要用/或者双反斜杠\\或者端口被别的程序占了。端口冲突检查方法netstat -ano | findstr 3306如果看到有进程占用3306再用tasklist | findstr PID号看看是谁占用的很多时候是之前装过的旧版MySQL残留服务或者刚好跑着一个别的数据库。把占用端口的程序关掉或者改MySQL端口号。7.2 登录时报Access denied区分密码错误和认证插件不匹配现象ERROR 1045 (28000): Access denied for user rootlocalhost (using password: YES)。这里要分两种情况一种是密码确实输错了另一种是认证插件和密码组合不匹配。8.0默认caching_sha2_password有时候密码是对的但客户端工具用的认证插件版本旧就会报这个错。解决思路是先用命令行本机登录命令行用新驱动一般没问题如果命令行能进客户端工具进不去那就是工具太旧去更新工具或者在MySQL里把账号的认证方式改成mysql_native_passwordALTER USER rootlocalhost IDENTIFIED WITH mysql_native_password BY 你的密码;如果命令行都进不去那大概率是密码忘了。别急MySQL有应急模式在my.ini的[mysqld]下加一行skip-grant-tables重启服务后不需要密码就能登录。登录后先执行FLUSH PRIVILEGES;再改密码改完后去my.ini里把skip-grant-tables删掉重启服务。注意skip-grant-tables是极度危险模式任何人都能无密码登录只能用于应急修复改完密码后务必立即删掉这一项。7.3 客户端连不上远程排查链路和常用工具现象远程电脑用Navicat或Workbench连接时提示Cant connect to MySQL server on x.x.x.x (10060)。10060这个错误码在Windows上很经典基本就是网络层面被拦截了。排查链路按顺序来先在本机测MySQL服务是否正常运行netstat -ano | findstr 3306能看到LISTENING状态就说明MySQL在等连接。在远程电脑上ping目标IP确认网络连通。如果ping不通查网络环境。确认MySQL端防火墙有放行3306。如果之前新建规则的步骤没做现在补上。确认MySQL的用户允许远程访问。SELECT user, host FROM mysql.user;看你要用的账号是不是%或明确包含了你的IP。如果以上都正常考虑云服务器安全组的问题。如果你用的是云服务器只放Windows防火墙还不够还要去云控制台的安全组里放行3306入方向规则。这一整套链路走下来绝大多数远程连接问题都能解决。不要上来就怀疑MySQL问题往往出在网络层。7.4 卸载重装时的高频残留问题装MySQL最烦的不是第一次装而是装坏了想重装却怎么都装不回去。这是因为MSI卸载器不会自动清理所有痕迹。如果你要彻底卸载重装下面这几个地方都要清干净控制面板或设置里卸载MySQL相关的所有程序删除安装目录比如C:\Program Files\MySQL和数据目录比如C:\ProgramData\MySQL运行services.msc看看有没有残留的MySQL服务。有的话用管理员命令行执行sc delete 服务名删除清理注册表。在注册表编辑器里搜索MySQL找到相关项删除。这一步有风险操作前建议先备份注册表没把握的话宁可谨慎一些只清理能明确确认的键值环境变量PATH里如果有MySQL的路径一并删掉。我之前见过一个情况旧版MySQL的data目录和数据没有删干净新版本装完后服务启动时加载了旧数据导致各种语法版本不兼容问题。所以重装之前数据备份和彻底清理一定要做齐全。8. 写在最后我踩过几次坑之后的一点个人建议这篇教程基本把MySQL在Windows上的安装路径全走了一遍。最后分享几个我在实际操作中攒下的体会。第一个建议是如果只是学习尽量用最新稳定版。别因为某篇教程说5.7稳、8.0新就纠结半天。MySQL 8.0从2018年GA到现在迭代了多个小版本稳定性早就不输5.7了而且8.0的命令、函数、特性就是以后的就业方向。早学早适应不亏。第二个建议装好后先做一次全量备份的演练。通过MySQL自带的mysqldump工具导出一份数据再试着恢复一遍确保备份机制是通的。很多人数据库跑了一两年都没备份过直到硬盘坏了才傻眼。这个演练花不了半个小时但关键时刻能救命。第三个建议一定把root密码保存在密码管理工具里不要存桌面文本文件更不要写在便利贴上。数据库管理员的最高权限密码泄露后果不是开玩笑的。最后如果在安装过程中遇到我这篇文章没有覆盖到的问题优先看MySQL的官方文档它是世界上最靠谱的参考资料虽然英文居多但结合翻译工具完全能看懂。也可以把错误日志里的[ERROR]行复制出来搜索一般都能找到答案。祝你的MySQL之路顺顺利利。