我帮人装 MySQL 的时候见过最多的情况不是安装包下不下来也不是配置多复杂而是很多人卡在装完打不开这一步。明明一步步照着教程点完了结果双击命令行一敲mysql不是提示不是内部或外部命令就是报一个让人看不懂的ERROR 2002。这篇文章就是不掺水地把 MySQL 数据库安装从头到尾捋一遍把每一步该点什么、为什么要这么点、点了之后会发生什么都说清楚尤其适合第一次接触数据库的小白照着操作。这篇内容覆盖 Windows 和 Linux 两条安装路线以 Windows 为主因为绝大多数初学者是从 Windows 开始接触 MySQL 的。全文没有会员专享、没有关注解锁就是一个老开发踩了无数次坑之后整理出来的完整实操记录。1. 下载之前先定三件事版本、平台、安装方式省得返工很多人下载 MySQL 的时候特别随意搜出来一个链接就点了装到一半才发现装的是个老掉牙的版本或者连社区版和商业版都没分清。其实下载前把下面这三件事定下来后面能省掉一半的麻烦。1.1 社区版和商业版你该下哪个MySQL 分好几个版本线最常见的是 Community Server社区版和 Enterprise Edition企业版。社区版用的是 GPL 开源协议功能上对个人学习、开发、甚至小型生产环境都完全够用。企业版多了技术支持、监控插件、备份工具这类商业化能力但那是给公司客户准备的普通用户根本用不到。我们这篇文章要装的就是MySQL Community Server。记住这个名字就够了下载的时候别选什么 Cluster、Router、HeatWave那些都是特定场景下的组件初学者装了只会让系统变乱。1.2 版本选 8.0 还是 5.7关键看两件事目前最新的大版本是 9.x但不要看到最新两个字就冲。MySQL 8.0 系列经过多年迭代已经非常稳定网上教程最多、踩坑记录最全是绝大多数项目的事实标准。8.4 是 LTS 长期支持版如果你想追求更长的维护周期可以选它。而 5.7 虽然老教程里还经常出现但它已经停止更新维护新装环境不建议再碰。我自己的建议很简单Windows 个人电脑装 8.0 系列最新小版本公司项目或服务器装 8.4 LTS 或 8.0不要装 9.x innovation 版求新鲜。这里要特别提一句8.0 默认的认证插件是caching_sha2_password比 5.7 时代的mysql_native_password更安全但有些老旧的图形客户端连不上。这个问题我在本文第 5 章会专门讲怎么处理先心里有个数即可。1.3 安装方式选 Installer 还是 ZIP 压缩包MySQL 在 Windows 上主流有两种安装方式安装方式适合人群特点MySQL Installer.exe 图形安装器绝大多数初学者图形界面点选自动处理 VC 运行库、注册服务、初始化数据目录ZIP 压缩包Noinstall想手动控制一切的人免安装解压后手动 init、手动配置 my.ini、手动注册服务如果你是第一次装直接选Installer 图形安装器。虽然它体积大一点但每一步都有界面提示还能自动帮你装好 Visual C 运行库省心。1.4 下载地址怎么找避开官网陷阱下载地址是这个https://dev.mysql.com/downloads/installer/这是 MySQL 官方开发者站点。注意是dev.mysql.com不是mysql.com首页也不是什么mysql-download.com。搜索引擎搜mysql 下载出来的前几条结果有不少是 SEO 引流站看着像官网实际点进去全是带推广参数的转发链接有的还捆绑全家桶。识别办法很简单域名必须包含mysql.com并且页面底部有 Oracle 的版权信息。国内用户如果从官网下载速度慢选一个知名镜像站也可以但建议先用官网官网下不动再考虑镜像。下载时选Windows (x86, 32-bit), ZIP Archive旁边的Go to Download Page或者直接选择那个几百 MB 的mysql-installer-community-8.0.x.msi文件。2. Windows 安装器全程实录Developer Default 选项背后那些默认行为安装器下载好之后双击运行。下面这段我把整个流程从头到尾走一遍每个选项是什么意思、该不该勾都拆开讲。2.1 Setup Type 怎么选Server only 还是 Developer Default安装器启动后会让你选安装类型主要选项有这几个Developer Default安装 MySQL Server MySQL Shell MySQL Workbench Router Visual Studio 插件等一堆组件省事但东西多。Server only只装 MySQL 数据库服务端干干净净。Full装全部组件。Custom手动勾选。我的建议是选Server only。初学者学数据库核心就是把服务跑起来、用命令行或一个客户端工具去操作它。MySQL Shell 和 Workbench 后面需要的时候随时可以补装但一开始少装点东西意味着后面要排查的环境变量更少、系统更干净。如果你确实需要一个可视化工具我后面第 4 章会提到 Workbench 怎么单独启用。选 Server only 不代表永远没有图形界面这点不用担心。2.2 Check Requirements卡住最多人的一步选完类型点 Next安装器会检查系统依赖最常见的就是缺Microsoft Visual C Redistributable。不同 MySQL 版本对 VC 运行库的要求不一样有些版本安装器会自动下载安装有些版本会弹窗让你手动装。这里有个小经验如果提示缺 VC 运行库不要绕过一定要装好。没有这个运行库mysqld.exe 启动会直接闪退你根本找不到原因。下载地址在微软官网搜 Visual C Redistributable 即可装最新版 x64 就行。2.3 实例配置端口、root 密码、认证插件依赖检查通过后就进入配置阶段这是整个安装过程的核心重点说几个关键配置项。Config Type 选 Development Machine这个选项影响 MySQL 对内存的预估占用。选Development Machine表示这是开发机MySQL 会按较小内存占用分配选Server Machine或Dedicated Machine会预留更多内存。个人电脑选 Development 完全够用。TCP/IP 端口 3306默认端口是 3306一般保持默认即可。如果你电脑上已经装了其他 MySQL 实例或者端口被占这里会显示一个红色的错误提示。遇到这种情况可以先看看是不是之前残留的 MySQL 服务在占用第 5 章有完整的排查方法。也可以用 3307 这种端口避免冲突但新手还是建议先解决占用问题保持默认端口会少很多后续配置麻烦。X Protocol 端口 33060这个是 MySQL 8.0 新增的 X Protocol 端口用于连接 MySQL Shell、文档存储等功能。默认勾选开启保持默认即可。如果看到端口被占同样先排查。root 密码和认证插件root 是 MySQL 的超级管理员账号密码务必设置一个你能记住但也别太简单的。注意 MySQL 的密码策略在中等级别下要求包含大小写字母、数字和特殊符号太简单的密码会直接不通过。认证插件那里保持默认的Use Strong Password Encryption (Recommend)就好对应caching_sha2_password。除非你的客户端工具特别老否则不要主动改成mysql_native_password。2.4 Windows Service 配置强烈建议勾选这一步问你是否把 MySQL 配置成 Windows 服务。强烈建议勾选并且启动类型选Start at System Startup。为什么配置成 Windows 服务之后MySQL 会像普通软件一样在后台运行你可以用net start mysql80/net stop mysql80这样的命令控制它也可以在任务管理器里看到它的状态。如果不配置成服务MySQL 只在命令行窗口打开的时候运行窗口一关服务就停了非常难受。服务名称默认是MySQL80记下来后面要用。2.5 Apply Configuration真正的初始化动作点完 Apply Configuration安装器会做这几件事写配置文件my.ini、初始化数据目录、把 mysqld 注册成 Windows 服务、启动服务。这个阶段如果提示failed千万别慌着重装先看具体报错。最常见的失败原因是端口被占、数据目录权限不对、VC 运行库缺失。看到Complete字样就说明配置成功点 Finish 收工。到这里MySQL 主体已经装好了。3. 装完别急着敲命令环境变量、服务管理、my.ini 三件套装完并不代表能直接用。很多人卡在装完不会用的状态里根本原因是漏掉了环境变量和服务管理这两件事。别急一样一样来。3.1 环境变量配置解决mysql 不是内部或外部命令打开命令行输入mysql --version如果提示mysql 不是内部或外部命令也不是可运行的程序或批处理文件。说明你的系统找不到 mysql.exe。这不是 MySQL 没装好而是没把 MySQL 的 bin 目录加到系统 PATH。解决方法如下右键此电脑 → 属性 → 高级系统设置 → 环境变量。在系统变量里找到Path双击编辑。点新建填入 MySQL 的 bin 目录路径默认是C:\Program Files\MySQL\MySQL Server 8.0\bin具体看你自己的安装目录确定保存重新打开一个命令行窗口再敲mysql --version就能看到版本信息了。这一步非常关键。无论你用什么客户端工具底层的命令行连接都依赖这个环境变量。3.2 服务管理启动、停止、查看状态MySQL 配置成 Windows 服务之后一切操作围绕服务展开。用管理员权限打开命令行net start mysql80 net stop mysql80 sc query mysql80net start mysql80启动 MySQL 服务。net stop mysql80停止服务。sc query mysql80查看服务当前状态看STATE那行是RUNNING还是STOPPED。也可以用图形化方式按Win R输入services.msc在服务列表里找到MySQL80右键启动/停止/重启。每次修改配置文件之后都需要重启服务才能生效这个后面会用到。3.3 my.ini 配置文件默认参数和必须知道的位置MySQL 的配置文件叫my.ini默认位置一般在C:\ProgramData\MySQL\MySQL Server 8.0\my.ini注意ProgramData是隐藏文件夹资源管理器里要勾选隐藏的项目才看得到。找不到的话在命令行执行mysql --help | findstr my.ini它会直接告诉你 MySQL 启动时会读取哪些位置的配置文件。新手最需要改的配置项有两个默认字符集在[mysqld]段下加一行character-set-serverutf8mb4这能避免建表时中文乱码非常实用。端口默认port3306如果你改了端口这里要对应修改。改完保存然后执行net stop mysql80net start mysql80重启服务。配置文件不是改完就生效的必须重启。3.4 第一条命令检查服务是否真的活着环境变量配好、服务也启动之后在命令行执行mysqladmin -u root -p status输入刚才设置的 root 密码如果显示Uptime之类的信息说明 MySQL 服务已经正常运作。这是安装成功与否的第一个硬指标。4. 第一次 mysql 连接实验从 -u root -p 到 show databases服务活了接下来就是第一次真正连接到 MySQL 数据库。4.1 mysql 命令行客户端的连接逻辑MySQL 自带一个命令行客户端安装目录 bin 下的mysql.exe。连接命令的完整写法是mysql -h 127.0.0.1 -P 3306 -u root -p各个参数的含义-h指定主机地址。127.0.0.1表示本机回环地址也可以写成localhost。-P指定端口默认是 3306保持默认时可以省略。-u指定用户名这里是 root。-p表示需要输入密码。实际情况下本机连接通常简写为mysql -u root -p回车后输入密码如果看到类似这样的输出说明你已经成功进入了 MySQL 的命令行环境Welcome to the MySQL monitor. Commands end with ; or \g. mysql这里有个新手高频率犯的错-p和密码之间不能有空格。比如-p 123456是错的MySQL 会把123456当成数据库名。正确写法是-p123456但更推荐先只写-p回车在提示符下输入密码这样密码不会显示在屏幕上。4.2 第一次进入后必做的两个验证进入mysql提示符之后先敲这两条命令SELECT VERSION(); SHOW DATABASES;第一条看版本第二条列出当前实例里所有数据库。默认情况下会有information_schema、mysql、performance_schema、sys这几个系统数据库。看到它们说明你的 MySQL 数据库安装已经完全跑通了。注意 MySQL 命令行里的每条 SQL 语句结尾都要加;并且按回车才会执行。忘了加分号的话你会看到提示符变成-这时候补一个分号回车就行不需要重新敲。4.3 密码错误和空密码的两种处理方式如果是第一次连接就报错ERROR 1045 (28000): Access denied for user rootlocalhost (using password: YES)说明密码不对。MySQL 安装器会让你在配置阶段设置 root 密码如果你当时留空了就会变成免密登录。这种情况先试试mysql -u root --skip-password能进去的话马上执行修改密码ALTER USER rootlocalhost IDENTIFIED BY 新密码;千万不要继续用空密码后面接任何外部系统都容易出问题。4.4 退出命令行操作完了直接输exit回车就能退出 MySQL 命令行环境。5. 高频报错排雷手册error 2002、3306 被占用、图形客户端连不上装 MySQL 的过程几乎人人都会遇到一两个报错。这一章把最高频的几个问题从完全不知道错在哪到最终解决完整走一遍排查链路。5.1 error 2002 (HY000)服务没起来或 socket 路径不对这个报错在 Linux 上出现的频率比 Windows 高得多。报错信息长这样ERROR 2002 (HY000): Cant connect to local MySQL server through socket /var/run/mysqld/mysqld.sock (2)它的核心意思是客户端尝试通过 socket 文件连接本地 MySQL 服务但没连上。注意这里说的是 socket 连接不是 TCP/IP。排查链路按顺序来第一步确认服务到底启动没有。执行systemctl status mysqld或者ps -ef | grep mysqld看不到 mysqld 进程说明服务压根没起来那问题就变成了服务为什么起不来。第二步查看 MySQL 错误日志。错误日志通常在/var/log/mysqld.log或/var/log/mysql/error.log。用tail -n 50看最后几十行里面会直接写明启动失败的原因比如磁盘满、配置文件语法错误、数据目录权限不对。第三步临时绕过 socket改用 TCP 连接。如果服务确实起来了但 socket 连不上可以试试mysql -h 127.0.0.1 -P 3306 -u root -pTCP 方式和 socket 方式走的是两条路。这个命令能连上的话说明问题只出在 socket 路径配置上不影响数据库本身使用。socket 路径可以在 my.cnf 的[mysqld]段里改保证客户端和服务端配置一致即可。Windows 下如果看到类似Cant connect to MySQL server on localhost十有八九是服务没启动直接执行net start mysql80然后在服务管理里看状态就行了。5.2 3306 端口被占用两个 MySQL 打架安装时报Port 3306 is already in use或者在命令行里连接被拒绝最可能的原因是端口被占用。Windows 下排查端口非常快netstat -ano | findstr :3306这一条命令会列出所有占用 3306 端口的连接最后一列是 PID。拿到 PID 之后tasklist | findstr PID就能看到是哪个进程。常见情况有两种之前装过一个 MySQL 服务还占着端口没释放。去服务管理里把所有 MySQL 相关服务都停掉再用net start mysql80启动你要的那个。系统里确实有其他程序占用了 3306。那就改 MySQL 端口编辑 my.ini 的port3307重启服务。后面连接时记得加-P 3307。我一直认为新人在这一步最容易犯的错是反复重装。实际上 90% 的安装问题都是端口或服务状态问题跟安装包没关系。5.3 Workbench 或 Navicat 连不上认证插件和 host 问题图形客户端工具连不上 MySQL常见场景有三个。场景一报Authentication plugin caching_sha2_password cannot be loaded。这是客户端版本太老不支持 MySQL 8.0 的默认认证插件。解决办法优先级最高的是升级客户端到支持caching_sha2_password的最新版本。如果因为某些原因不能升级可以把该用户的认证插件改回旧的ALTER USER rootlocalhost IDENTIFIED WITH mysql_native_password BY 你的密码;注意改回去之后密码策略可能变宽松这对安全性有影响生产环境不建议这么做。场景二报Access denied。检查用户名密码有没有输错同时确认你在 Workbench 或 Navicat 里填的用户名是root主机是localhost或127.0.0.1。如果用的 host 是127.0.0.1但 MySQL 只授权了rootlocalhost也可能连不上。场景三连接直接超时。确保 MySQL 服务启动、Windows 防火墙没拦 3306 端口。如果是在云服务器上装 MySQL还要检查安全组的入方向是否放行了 3306。5.4 忘记 root 密码怎么办忘了密码是另一个高频问题。做法是先停服务再用跳过授权表的方式启动然后改密码最后恢复正常模式。Windows 下net stop mysql80然后在命令行里手动启动mysqld --skip-grant-tables这时再开一个命令行窗口执行mysql -u root就能无密码进入然后立刻执行FLUSH PRIVILEGES; ALTER USER rootlocalhost IDENTIFIED BY 新密码;改完关掉那个手动启动的 mysqld 窗口重新net start mysql80恢复正常模式。这个方法能救命但--skip-grant-tables会让 MySQL 完全放弃权限检查只能在本地紧急维护时用处理完要马上关掉恢复。6. 顺带提一嘴的 Linux 安装路线有服务器的再往下看如果你手上有台 Linux 服务器或者做后端开发需要在服务器上装 MySQL这条路线也一并给了。6.1 包管理器安装和官方仓库在 Debian/Ubuntu 上一行命令的事sudo apt update sudo apt install mysql-server在 CentOS/RHEL 上sudo yum install mysql-server但注意系统自带的软件源里 MySQL 版本可能不是最新的。想用官方最新版更标准的做法是先添加 MySQL 官方仓库再安装wget https://dev.mysql.com/get/mysql-apt-config_0.8.22-1_all.deb sudo dpkg -i mysql-apt-config_0.8.22-1_all.deb sudo apt update sudo apt install mysql-server装完之后Ubuntu/Debian 上 MySQL 服务通常会自动启动。CentOS 上可能需要手动开启sudo systemctl start mysqld sudo systemctl enable mysqld6.2 临时密码和初始化操作CentOS/RHEL 系的 MySQL 安装后会给 root 生成一个临时密码写在日志里sudo grep temporary password /var/log/mysqld.log拿到临时密码之后登录然后立刻改密码mysql -u root -pALTER USER rootlocalhost IDENTIFIED BY 你的新密码;Ubuntu 系安装的时候安装过程中就会直接让你设置 root 密码不需要走临时密码这一步。不管哪个发行版安装完之后建议跑一遍安全初始化sudo mysql_secure_installation这个命令会引导你设置密码强度、移除匿名用户、禁用 root 远程登录如果不需要的话、删除测试数据库。新装的 MySQL 跑一遍这个心理上踏实很多。6.3 Linux 下远程连接要开的几道口子Linux 上的 MySQL 默认只监听本地远程客户端连不上。想从本机用 Navicat 或 Workbench 连服务器上的 MySQL要注意三件事bind-address 配置编辑/etc/mysql/mysql.conf.d/mysqld.cnf或/etc/my.cnf把bind-address 127.0.0.1改成0.0.0.0然后重启服务。用户授权MySQL 8.0 默认 root 用户只能从 localhost 登录需要创建一个远程访问账号CREATE USER appuser% IDENTIFIED BY 强密码; GRANT ALL PRIVILEGES ON *.* TO appuser%; FLUSH PRIVILEGES;防火墙放行 3306Ubuntu 的 ufw 执行sudo ufw allow 3306/tcp云服务器还要在安全组里放行。这里多说一句把 MySQL 端口直接暴露到公网是一把双刃剑。个人开发环境图省事可以开但正经生产环境建议只允许内网访问或者通过 SSH 隧道连接不要图方便给%开万能授权。结尾我个人在实际操作中的体会是MySQL 安装本身只占 20% 的工作量剩下 80% 全在安装完之后的验证和排错。环境变量配好、服务状态管好、日志文件知道去哪里看这三件事做扎实MySQL 安装这件事就算真正通关了。最后再分享一个小技巧装完 MySQL 之后第一步先别急着建数据库、建表先SHOW DATABASES;看一眼默认实例状态第二步手动重启一次服务确认重启之后连接不受影响第三步把 root 密码放进密码管理器。这三步做完后面再想折腾什么都有底气。
MySQL安装全攻略：从下载到排错，小白也能一次搞定
我帮人装 MySQL 的时候见过最多的情况不是安装包下不下来也不是配置多复杂而是很多人卡在装完打不开这一步。明明一步步照着教程点完了结果双击命令行一敲mysql不是提示不是内部或外部命令就是报一个让人看不懂的ERROR 2002。这篇文章就是不掺水地把 MySQL 数据库安装从头到尾捋一遍把每一步该点什么、为什么要这么点、点了之后会发生什么都说清楚尤其适合第一次接触数据库的小白照着操作。这篇内容覆盖 Windows 和 Linux 两条安装路线以 Windows 为主因为绝大多数初学者是从 Windows 开始接触 MySQL 的。全文没有会员专享、没有关注解锁就是一个老开发踩了无数次坑之后整理出来的完整实操记录。1. 下载之前先定三件事版本、平台、安装方式省得返工很多人下载 MySQL 的时候特别随意搜出来一个链接就点了装到一半才发现装的是个老掉牙的版本或者连社区版和商业版都没分清。其实下载前把下面这三件事定下来后面能省掉一半的麻烦。1.1 社区版和商业版你该下哪个MySQL 分好几个版本线最常见的是 Community Server社区版和 Enterprise Edition企业版。社区版用的是 GPL 开源协议功能上对个人学习、开发、甚至小型生产环境都完全够用。企业版多了技术支持、监控插件、备份工具这类商业化能力但那是给公司客户准备的普通用户根本用不到。我们这篇文章要装的就是MySQL Community Server。记住这个名字就够了下载的时候别选什么 Cluster、Router、HeatWave那些都是特定场景下的组件初学者装了只会让系统变乱。1.2 版本选 8.0 还是 5.7关键看两件事目前最新的大版本是 9.x但不要看到最新两个字就冲。MySQL 8.0 系列经过多年迭代已经非常稳定网上教程最多、踩坑记录最全是绝大多数项目的事实标准。8.4 是 LTS 长期支持版如果你想追求更长的维护周期可以选它。而 5.7 虽然老教程里还经常出现但它已经停止更新维护新装环境不建议再碰。我自己的建议很简单Windows 个人电脑装 8.0 系列最新小版本公司项目或服务器装 8.4 LTS 或 8.0不要装 9.x innovation 版求新鲜。这里要特别提一句8.0 默认的认证插件是caching_sha2_password比 5.7 时代的mysql_native_password更安全但有些老旧的图形客户端连不上。这个问题我在本文第 5 章会专门讲怎么处理先心里有个数即可。1.3 安装方式选 Installer 还是 ZIP 压缩包MySQL 在 Windows 上主流有两种安装方式安装方式适合人群特点MySQL Installer.exe 图形安装器绝大多数初学者图形界面点选自动处理 VC 运行库、注册服务、初始化数据目录ZIP 压缩包Noinstall想手动控制一切的人免安装解压后手动 init、手动配置 my.ini、手动注册服务如果你是第一次装直接选Installer 图形安装器。虽然它体积大一点但每一步都有界面提示还能自动帮你装好 Visual C 运行库省心。1.4 下载地址怎么找避开官网陷阱下载地址是这个https://dev.mysql.com/downloads/installer/这是 MySQL 官方开发者站点。注意是dev.mysql.com不是mysql.com首页也不是什么mysql-download.com。搜索引擎搜mysql 下载出来的前几条结果有不少是 SEO 引流站看着像官网实际点进去全是带推广参数的转发链接有的还捆绑全家桶。识别办法很简单域名必须包含mysql.com并且页面底部有 Oracle 的版权信息。国内用户如果从官网下载速度慢选一个知名镜像站也可以但建议先用官网官网下不动再考虑镜像。下载时选Windows (x86, 32-bit), ZIP Archive旁边的Go to Download Page或者直接选择那个几百 MB 的mysql-installer-community-8.0.x.msi文件。2. Windows 安装器全程实录Developer Default 选项背后那些默认行为安装器下载好之后双击运行。下面这段我把整个流程从头到尾走一遍每个选项是什么意思、该不该勾都拆开讲。2.1 Setup Type 怎么选Server only 还是 Developer Default安装器启动后会让你选安装类型主要选项有这几个Developer Default安装 MySQL Server MySQL Shell MySQL Workbench Router Visual Studio 插件等一堆组件省事但东西多。Server only只装 MySQL 数据库服务端干干净净。Full装全部组件。Custom手动勾选。我的建议是选Server only。初学者学数据库核心就是把服务跑起来、用命令行或一个客户端工具去操作它。MySQL Shell 和 Workbench 后面需要的时候随时可以补装但一开始少装点东西意味着后面要排查的环境变量更少、系统更干净。如果你确实需要一个可视化工具我后面第 4 章会提到 Workbench 怎么单独启用。选 Server only 不代表永远没有图形界面这点不用担心。2.2 Check Requirements卡住最多人的一步选完类型点 Next安装器会检查系统依赖最常见的就是缺Microsoft Visual C Redistributable。不同 MySQL 版本对 VC 运行库的要求不一样有些版本安装器会自动下载安装有些版本会弹窗让你手动装。这里有个小经验如果提示缺 VC 运行库不要绕过一定要装好。没有这个运行库mysqld.exe 启动会直接闪退你根本找不到原因。下载地址在微软官网搜 Visual C Redistributable 即可装最新版 x64 就行。2.3 实例配置端口、root 密码、认证插件依赖检查通过后就进入配置阶段这是整个安装过程的核心重点说几个关键配置项。Config Type 选 Development Machine这个选项影响 MySQL 对内存的预估占用。选Development Machine表示这是开发机MySQL 会按较小内存占用分配选Server Machine或Dedicated Machine会预留更多内存。个人电脑选 Development 完全够用。TCP/IP 端口 3306默认端口是 3306一般保持默认即可。如果你电脑上已经装了其他 MySQL 实例或者端口被占这里会显示一个红色的错误提示。遇到这种情况可以先看看是不是之前残留的 MySQL 服务在占用第 5 章有完整的排查方法。也可以用 3307 这种端口避免冲突但新手还是建议先解决占用问题保持默认端口会少很多后续配置麻烦。X Protocol 端口 33060这个是 MySQL 8.0 新增的 X Protocol 端口用于连接 MySQL Shell、文档存储等功能。默认勾选开启保持默认即可。如果看到端口被占同样先排查。root 密码和认证插件root 是 MySQL 的超级管理员账号密码务必设置一个你能记住但也别太简单的。注意 MySQL 的密码策略在中等级别下要求包含大小写字母、数字和特殊符号太简单的密码会直接不通过。认证插件那里保持默认的Use Strong Password Encryption (Recommend)就好对应caching_sha2_password。除非你的客户端工具特别老否则不要主动改成mysql_native_password。2.4 Windows Service 配置强烈建议勾选这一步问你是否把 MySQL 配置成 Windows 服务。强烈建议勾选并且启动类型选Start at System Startup。为什么配置成 Windows 服务之后MySQL 会像普通软件一样在后台运行你可以用net start mysql80/net stop mysql80这样的命令控制它也可以在任务管理器里看到它的状态。如果不配置成服务MySQL 只在命令行窗口打开的时候运行窗口一关服务就停了非常难受。服务名称默认是MySQL80记下来后面要用。2.5 Apply Configuration真正的初始化动作点完 Apply Configuration安装器会做这几件事写配置文件my.ini、初始化数据目录、把 mysqld 注册成 Windows 服务、启动服务。这个阶段如果提示failed千万别慌着重装先看具体报错。最常见的失败原因是端口被占、数据目录权限不对、VC 运行库缺失。看到Complete字样就说明配置成功点 Finish 收工。到这里MySQL 主体已经装好了。3. 装完别急着敲命令环境变量、服务管理、my.ini 三件套装完并不代表能直接用。很多人卡在装完不会用的状态里根本原因是漏掉了环境变量和服务管理这两件事。别急一样一样来。3.1 环境变量配置解决mysql 不是内部或外部命令打开命令行输入mysql --version如果提示mysql 不是内部或外部命令也不是可运行的程序或批处理文件。说明你的系统找不到 mysql.exe。这不是 MySQL 没装好而是没把 MySQL 的 bin 目录加到系统 PATH。解决方法如下右键此电脑 → 属性 → 高级系统设置 → 环境变量。在系统变量里找到Path双击编辑。点新建填入 MySQL 的 bin 目录路径默认是C:\Program Files\MySQL\MySQL Server 8.0\bin具体看你自己的安装目录确定保存重新打开一个命令行窗口再敲mysql --version就能看到版本信息了。这一步非常关键。无论你用什么客户端工具底层的命令行连接都依赖这个环境变量。3.2 服务管理启动、停止、查看状态MySQL 配置成 Windows 服务之后一切操作围绕服务展开。用管理员权限打开命令行net start mysql80 net stop mysql80 sc query mysql80net start mysql80启动 MySQL 服务。net stop mysql80停止服务。sc query mysql80查看服务当前状态看STATE那行是RUNNING还是STOPPED。也可以用图形化方式按Win R输入services.msc在服务列表里找到MySQL80右键启动/停止/重启。每次修改配置文件之后都需要重启服务才能生效这个后面会用到。3.3 my.ini 配置文件默认参数和必须知道的位置MySQL 的配置文件叫my.ini默认位置一般在C:\ProgramData\MySQL\MySQL Server 8.0\my.ini注意ProgramData是隐藏文件夹资源管理器里要勾选隐藏的项目才看得到。找不到的话在命令行执行mysql --help | findstr my.ini它会直接告诉你 MySQL 启动时会读取哪些位置的配置文件。新手最需要改的配置项有两个默认字符集在[mysqld]段下加一行character-set-serverutf8mb4这能避免建表时中文乱码非常实用。端口默认port3306如果你改了端口这里要对应修改。改完保存然后执行net stop mysql80net start mysql80重启服务。配置文件不是改完就生效的必须重启。3.4 第一条命令检查服务是否真的活着环境变量配好、服务也启动之后在命令行执行mysqladmin -u root -p status输入刚才设置的 root 密码如果显示Uptime之类的信息说明 MySQL 服务已经正常运作。这是安装成功与否的第一个硬指标。4. 第一次 mysql 连接实验从 -u root -p 到 show databases服务活了接下来就是第一次真正连接到 MySQL 数据库。4.1 mysql 命令行客户端的连接逻辑MySQL 自带一个命令行客户端安装目录 bin 下的mysql.exe。连接命令的完整写法是mysql -h 127.0.0.1 -P 3306 -u root -p各个参数的含义-h指定主机地址。127.0.0.1表示本机回环地址也可以写成localhost。-P指定端口默认是 3306保持默认时可以省略。-u指定用户名这里是 root。-p表示需要输入密码。实际情况下本机连接通常简写为mysql -u root -p回车后输入密码如果看到类似这样的输出说明你已经成功进入了 MySQL 的命令行环境Welcome to the MySQL monitor. Commands end with ; or \g. mysql这里有个新手高频率犯的错-p和密码之间不能有空格。比如-p 123456是错的MySQL 会把123456当成数据库名。正确写法是-p123456但更推荐先只写-p回车在提示符下输入密码这样密码不会显示在屏幕上。4.2 第一次进入后必做的两个验证进入mysql提示符之后先敲这两条命令SELECT VERSION(); SHOW DATABASES;第一条看版本第二条列出当前实例里所有数据库。默认情况下会有information_schema、mysql、performance_schema、sys这几个系统数据库。看到它们说明你的 MySQL 数据库安装已经完全跑通了。注意 MySQL 命令行里的每条 SQL 语句结尾都要加;并且按回车才会执行。忘了加分号的话你会看到提示符变成-这时候补一个分号回车就行不需要重新敲。4.3 密码错误和空密码的两种处理方式如果是第一次连接就报错ERROR 1045 (28000): Access denied for user rootlocalhost (using password: YES)说明密码不对。MySQL 安装器会让你在配置阶段设置 root 密码如果你当时留空了就会变成免密登录。这种情况先试试mysql -u root --skip-password能进去的话马上执行修改密码ALTER USER rootlocalhost IDENTIFIED BY 新密码;千万不要继续用空密码后面接任何外部系统都容易出问题。4.4 退出命令行操作完了直接输exit回车就能退出 MySQL 命令行环境。5. 高频报错排雷手册error 2002、3306 被占用、图形客户端连不上装 MySQL 的过程几乎人人都会遇到一两个报错。这一章把最高频的几个问题从完全不知道错在哪到最终解决完整走一遍排查链路。5.1 error 2002 (HY000)服务没起来或 socket 路径不对这个报错在 Linux 上出现的频率比 Windows 高得多。报错信息长这样ERROR 2002 (HY000): Cant connect to local MySQL server through socket /var/run/mysqld/mysqld.sock (2)它的核心意思是客户端尝试通过 socket 文件连接本地 MySQL 服务但没连上。注意这里说的是 socket 连接不是 TCP/IP。排查链路按顺序来第一步确认服务到底启动没有。执行systemctl status mysqld或者ps -ef | grep mysqld看不到 mysqld 进程说明服务压根没起来那问题就变成了服务为什么起不来。第二步查看 MySQL 错误日志。错误日志通常在/var/log/mysqld.log或/var/log/mysql/error.log。用tail -n 50看最后几十行里面会直接写明启动失败的原因比如磁盘满、配置文件语法错误、数据目录权限不对。第三步临时绕过 socket改用 TCP 连接。如果服务确实起来了但 socket 连不上可以试试mysql -h 127.0.0.1 -P 3306 -u root -pTCP 方式和 socket 方式走的是两条路。这个命令能连上的话说明问题只出在 socket 路径配置上不影响数据库本身使用。socket 路径可以在 my.cnf 的[mysqld]段里改保证客户端和服务端配置一致即可。Windows 下如果看到类似Cant connect to MySQL server on localhost十有八九是服务没启动直接执行net start mysql80然后在服务管理里看状态就行了。5.2 3306 端口被占用两个 MySQL 打架安装时报Port 3306 is already in use或者在命令行里连接被拒绝最可能的原因是端口被占用。Windows 下排查端口非常快netstat -ano | findstr :3306这一条命令会列出所有占用 3306 端口的连接最后一列是 PID。拿到 PID 之后tasklist | findstr PID就能看到是哪个进程。常见情况有两种之前装过一个 MySQL 服务还占着端口没释放。去服务管理里把所有 MySQL 相关服务都停掉再用net start mysql80启动你要的那个。系统里确实有其他程序占用了 3306。那就改 MySQL 端口编辑 my.ini 的port3307重启服务。后面连接时记得加-P 3307。我一直认为新人在这一步最容易犯的错是反复重装。实际上 90% 的安装问题都是端口或服务状态问题跟安装包没关系。5.3 Workbench 或 Navicat 连不上认证插件和 host 问题图形客户端工具连不上 MySQL常见场景有三个。场景一报Authentication plugin caching_sha2_password cannot be loaded。这是客户端版本太老不支持 MySQL 8.0 的默认认证插件。解决办法优先级最高的是升级客户端到支持caching_sha2_password的最新版本。如果因为某些原因不能升级可以把该用户的认证插件改回旧的ALTER USER rootlocalhost IDENTIFIED WITH mysql_native_password BY 你的密码;注意改回去之后密码策略可能变宽松这对安全性有影响生产环境不建议这么做。场景二报Access denied。检查用户名密码有没有输错同时确认你在 Workbench 或 Navicat 里填的用户名是root主机是localhost或127.0.0.1。如果用的 host 是127.0.0.1但 MySQL 只授权了rootlocalhost也可能连不上。场景三连接直接超时。确保 MySQL 服务启动、Windows 防火墙没拦 3306 端口。如果是在云服务器上装 MySQL还要检查安全组的入方向是否放行了 3306。5.4 忘记 root 密码怎么办忘了密码是另一个高频问题。做法是先停服务再用跳过授权表的方式启动然后改密码最后恢复正常模式。Windows 下net stop mysql80然后在命令行里手动启动mysqld --skip-grant-tables这时再开一个命令行窗口执行mysql -u root就能无密码进入然后立刻执行FLUSH PRIVILEGES; ALTER USER rootlocalhost IDENTIFIED BY 新密码;改完关掉那个手动启动的 mysqld 窗口重新net start mysql80恢复正常模式。这个方法能救命但--skip-grant-tables会让 MySQL 完全放弃权限检查只能在本地紧急维护时用处理完要马上关掉恢复。6. 顺带提一嘴的 Linux 安装路线有服务器的再往下看如果你手上有台 Linux 服务器或者做后端开发需要在服务器上装 MySQL这条路线也一并给了。6.1 包管理器安装和官方仓库在 Debian/Ubuntu 上一行命令的事sudo apt update sudo apt install mysql-server在 CentOS/RHEL 上sudo yum install mysql-server但注意系统自带的软件源里 MySQL 版本可能不是最新的。想用官方最新版更标准的做法是先添加 MySQL 官方仓库再安装wget https://dev.mysql.com/get/mysql-apt-config_0.8.22-1_all.deb sudo dpkg -i mysql-apt-config_0.8.22-1_all.deb sudo apt update sudo apt install mysql-server装完之后Ubuntu/Debian 上 MySQL 服务通常会自动启动。CentOS 上可能需要手动开启sudo systemctl start mysqld sudo systemctl enable mysqld6.2 临时密码和初始化操作CentOS/RHEL 系的 MySQL 安装后会给 root 生成一个临时密码写在日志里sudo grep temporary password /var/log/mysqld.log拿到临时密码之后登录然后立刻改密码mysql -u root -pALTER USER rootlocalhost IDENTIFIED BY 你的新密码;Ubuntu 系安装的时候安装过程中就会直接让你设置 root 密码不需要走临时密码这一步。不管哪个发行版安装完之后建议跑一遍安全初始化sudo mysql_secure_installation这个命令会引导你设置密码强度、移除匿名用户、禁用 root 远程登录如果不需要的话、删除测试数据库。新装的 MySQL 跑一遍这个心理上踏实很多。6.3 Linux 下远程连接要开的几道口子Linux 上的 MySQL 默认只监听本地远程客户端连不上。想从本机用 Navicat 或 Workbench 连服务器上的 MySQL要注意三件事bind-address 配置编辑/etc/mysql/mysql.conf.d/mysqld.cnf或/etc/my.cnf把bind-address 127.0.0.1改成0.0.0.0然后重启服务。用户授权MySQL 8.0 默认 root 用户只能从 localhost 登录需要创建一个远程访问账号CREATE USER appuser% IDENTIFIED BY 强密码; GRANT ALL PRIVILEGES ON *.* TO appuser%; FLUSH PRIVILEGES;防火墙放行 3306Ubuntu 的 ufw 执行sudo ufw allow 3306/tcp云服务器还要在安全组里放行。这里多说一句把 MySQL 端口直接暴露到公网是一把双刃剑。个人开发环境图省事可以开但正经生产环境建议只允许内网访问或者通过 SSH 隧道连接不要图方便给%开万能授权。结尾我个人在实际操作中的体会是MySQL 安装本身只占 20% 的工作量剩下 80% 全在安装完之后的验证和排错。环境变量配好、服务状态管好、日志文件知道去哪里看这三件事做扎实MySQL 安装这件事就算真正通关了。最后再分享一个小技巧装完 MySQL 之后第一步先别急着建数据库、建表先SHOW DATABASES;看一眼默认实例状态第二步手动重启一次服务确认重启之后连接不受影响第三步把 root 密码放进密码管理器。这三步做完后面再想折腾什么都有底气。
