MySQL安装全攻略：Windows/Linux/macOS平台手把手教程

很多朋友第一次接触数据库第一个挑的基本都是 MySQL。它免费、开源、教程又多网上随便一搜全是资料。但真到自己动手安装的时候坑也不少下载页面看得眼花缭乱版本号不知道选哪个好装到一半提示缺少组件好不容易选完配置又连不上服务折腾一晚上还在原地踏步。这篇文章就把 MySQL 安装的整个过程拆开揉碎讲清楚从下载哪个版本、安装时哪些选项该勾到 my.ini 怎么写、环境变量怎么配再到装好后怎么登录验证、遇上报错怎么排查全程按照新手的操作习惯来写。主力讲 Windows 平台Linux 和 macOS 也会给出一套稳妥的流程不管你是做课程设计、准备毕业项目还是刚入职需要搭本地开发环境照着这篇做完基本就能跑起来。1. 安装前必须想明白的三件事1.1 版本这么多到底该下载哪一个打开 MySQL 官网的下载页很多人第一反应是懵的。页面上一堆产品名称和版本号什么 MySQL Community Server、MySQL Enterprise、MySQL Cluster还有 8.0、8.4、9.x 之类的编号。这里直接给结论个人学习、开发调试、做毕设选MySQL Community Server就够用了。MySQL 社区版是开源的 GPL 协议免费下载使用功能上完全覆盖日常开发需求。企业版多出来的那些功能比如企业级备份、防火墙、监控工具之类基本都是公司采购才会用到个人学习阶段根本不需要。版本号方面如果你打开下载页看到的还是 8.0.x 系列直接挑最新的 8.0 稳定版下载。现在 8.0 已经非常成熟网上绝大多数教程、课程、框架兼容性都是围绕 8.0 写的。如果你看到 8.4 LTS 或者 9.x也不是不能用但没必要去追新。追新的结果往往是装好了、能启动跑到某个框架连接时发现驱动版本对不上又得折腾半天。我个人的建议是学习阶段选主流稳定版别给自己挖坑。另外 5.7 系列早就不维护了千万不要因为某个老项目的历史教程去装 5.7安全漏洞和兼容性问题都很难处理。1.2 不同系统安装姿势完全不一样安装 MySQL 没有一套命令通吃所有平台的说法。Windows用户通常有两种方式一种是下载 MSI 安装包像装普通软件一样走图形化向导另一种是下载 ZIP 压缩包解压后手动配置服务。新手我更推荐 MSI 方式选项都在界面上每一步都有提示不容易漏掉关键配置。Linux用户则习惯用系统自带的包管理器Ubuntu/Debian 用 aptCentOS/RHEL 用 yum 或 dnf也可以添加 MySQL 官方仓库后用包管理器安装方式不同但都算方便。macOS用户最简单装 Homebrew 后一条命令就能装好包管理器会自动把依赖、文件路径都搞定。可能有人问为什么不能统一用解压即用的绿色版搞定因为 MySQL 本质上是一个服务端程序它需要以系统服务的方式常驻后台运行还要维护数据目录、日志文件、权限配置。不同的系统对服务的注册和管理方式不一样Windows 服务、Linux 的 systemd、macOS 的 launchd各自有各自的规则所以安装方式才会分道扬镳。1.3 动手之前先把环境收拾干净这是小白最容易忽略的一步。如果你电脑上以前装过 MySQL或者装过某些集成环境比如 phpStudy、XAMPP 里的 MySQL 模块不卸载干净就直接装新版大概率会撞车。最典型的表现是安装向导走到最后一步配置时提示端口被占用或者服务怎么也启动不起来。所以在开始之前建议先做三件事。第一按下Win R输入services.msc打开服务列表看看有没有名字里带 MySQL 的服务在运行如果有先停止并禁用。第二检查 3306 端口是不是被占用了在 cmd 里执行netstat -ano | findstr :3306如果有输出说明有程序正在监听这个端口得先找出是哪个进程占用的。第三如果以前装过 MySQL去C:\Program Files\MySQL和C:\ProgramData\MySQL这两个目录看看有残留文件的话建议备份后删除这里的 ProgramData 是隐藏目录需要在资源管理器里开启“显示隐藏的项目”。2. Windows 超详细安装流程2.1 下载安装包之前先学会看文件名在浏览器里打开 MySQL 官网的下载区域找到 MySQL Community Server 的下载链接。进入下载列表后你会看到一堆文件这里教大家怎么看文件名比如mysql-installer-community-8.0.xx.msi这就是 Windows 图形化安装程序community 表示社区版数字是版本号msi 后缀表示双击就能安装。另一个常见文件是mysql-8.0.xx-winx64.zip这是免安装的压缩包以后想手动控制一切的话可以选它。新手直接下载MSI 安装包就好。有一点要特别注意看系统位数现在的电脑基本都是 64 位系统选 x64 的安装包如果是老古董 32 位系统就需要找对应的 x86 版本。还有一个容易忽略的点在下载页面里可能会看到 Debug 版、带测试组件的版本那些不是给普通用户用的一律忽略。下载完成后双击安装包之前先确认一下自己的系统是否已经安装了 Microsoft Visual C 运行库。MySQL 安装程序本身依赖这个运行库如果缺了安装过程中可能会直接报错走不下去。没有的话先去微软官网下载最新的 Visual C Redistributable for Visual Studio 装上这个步骤几分钟就能完成。2.2 MSI 安装向导每个选项该怎么选安装程序启动后第一步是选择一个 Setup Type会有 Developer Default、Server only、Client only、Full、Custom 几个选项。这里不要选 Developer Default虽然它听起来很全面但实际上会把一堆你用不上的组件一起装上比如 MySQL Connector、文档、示例数据库等装得慢还占空间。对只是想用数据库的人来说选Server only最干净。但如果你后面想用可视化工具其实命令行就能搞定我一般会选 Custom然后在组件列表里只勾选 MySQL Server其他组件一律不勾需要的时候再补装就行。接下来是 Check Requirements 环节安装程序会检查系统是否满足运行条件比如 VC 运行库是否完整。如果这步检查失败界面会显示缺少哪些组件并提供“Execute”按钮自动去下载安装。这步安装网络可能要稍微等一会装完点重新检查一般就能通过。组件安装完成之后会进入 Product Configuration 配置环节这是整个安装过程中最容易出错的部分务必仔细看。首先是 Type 和 Networking 页面默认选项是 Standalone MySQL Server / Classic MySQL Replication开发模式选择 Development Machine 就够了。下面有一个Config Type的选择通常是 Development Machine这个选项会影响 MySQL 占用的内存默认值选 Development Machine 就是按开发机来优化资源占用适中。端口默认是 3306不要改除非你确实知道 3306 被什么重要服务占了。然后是 Authentication Method新版 MySQL 8 推荐使用caching_sha2_password这是默认选项保持它就行。接着是最关键的 Root Password 设置输入一个你觉得好记但又不能太简单的密码后面所有连接登录都靠它。下方还可以添加一个或多个 MySQL User Account这一步可以创建一个日常使用的普通账号。我建议一定要建一个因为直接用 root 操作生产习惯很不好但在本地学习环境里不创建也没关系后续随时可以补。最后一步是 Windows Service 配置界面上默认勾选了“Configure MySQL Server as a Windows Service”服务名保持默认的MySQL80即可勾上“Start at Windows Startup”这样开机后数据库会自动启动。下面还有一个“Run as NT Service”的选项意思是让 MySQL 以系统服务账户运行保持默认即可。全部配置完成后点击 Execute等进度条走完如果显示绿色对勾说明配置成功然后 Finish。2.3 想彻底掌控配置试一下 ZIP 免安装方案用 MSI 装完就没法直接看到 my.ini虽然也能找到配置文件但它藏在隐藏目录里想改还得用管理员权限。如果你想像老手一样完全掌控数据库的每项参数建议试试 ZIP 免安装方案。这种方式更接近 Linux 的玩法所有文件都在一个目录里配置、数据、日志都放在你自己制定好的位置万一环境出问题直接删文件夹就是彻底卸载不残留任何服务。具体做法是解压下载的 ZIP 包到一个纯英文路径比如D:\mysql-8.0.xx-winx64然后在这个目录下新建一个my.ini文件内容参考下面这套基础配置。[mysqld] # 安装目录改成你自己的实际路径 basedirD:/mysql-8.0.xx-winx64 # 数据目录可以放在安装目录外面方便备份 datadirD:/mysql-data # 端口默认3306 port3306 # 服务唯一标识多实例时才需要注意 server-id1 # 字符集统一用utf8mb4 character-set-serverutf8mb4 # 排序规则跟utf8mb4配套 collation-serverutf8mb4_unicode_ci [client] # 客户端默认连接端口 port3306 default-character-setutf8mb4注意 datadir 指向的目录要提前建好并且路径里不要有中文。然后以管理员身份打开 cmd进入解压目录的 bin 目录执行初始化命令mysqld --initialize-insecure这个命令会生成一个初始无密码的 root 账号适合第一次安装后直接登录再改密。初始化完成后执行mysqld --install MySQL80 net start MySQL80这样就把 MySQL 注册成 Windows 服务了。第一次启动可能会慢一点因为它要初始化数据文件。安装完成后用mysql -uroot -p登录密码直接回车因为是无密码状态登录成功后第一件事就是改成自己的密码务必要改。2.4 root 密码和账号安全装完第一时间处理很多人装好 MySQL 后用 no 密码直接登录或者一直用默认密码不管这是非常不好的习惯。不管用 MSI 还是 ZIP 方式安装装好之后第一件事就是登录数据库设置一个自己明确知道的密码不要保留临时密码或空密码状态。如果用的是 MSI 安装向导设置过的密码就是 root 密码直接登录就行了。如果用的是 ZIP --initialize-insecure登录后建议立刻执行下面的 SQL 修改密码ALTER USER rootlocalhost IDENTIFIED BY 新密码; FLUSH PRIVILEGES;这里推荐至少 8 位以上、包含大小写字母和数字的密码。密码设置完成之后建议再建一个日常使用的账号避免所有操作都用 rootCREATE USER devlocalhost IDENTIFIED BY 开发密码; GRANT ALL PRIVILEGES ON *.* TO devlocalhost; FLUSH PRIVILEGES;如果这是你自己的本地开发环境这样做已经足够了。如果这台机器要作为服务器给别的机器连接那就需要额外开放权限在 MySQL 环境里要把用户从devlocalhost改成dev%并且检查防火墙是否放行 3306 端口。这里多说一句远程开放 root 账号是最危险的操作千万不要为了图省事直接允许 root 从任意地址登录。3. Linux 和 macOS 的安装要点3.1 Linux一条命令安装但初始化别偷懒Linux 上安装 MySQL 的最大优势就是包管理器直接搞定依赖不需要像 Windows 那样手动配置一堆东西。以 Ubuntu/Debian 为例安装命令就两行sudo apt update sudo apt install mysql-server装完之后 MySQL 服务默认会启动可以用sudo systemctl status mysql检查状态。刚安装完的 Ubuntu 系统上root 账号默认用的是 auth_socket 认证插件也就是说你用系统的 root 或 sudo 权限直接登录 MySQL 时不需要密码。这时候千万别觉得“不用密码挺好的”还是要执行sudo mysql_secure_installation做一次安全初始化这个命令会引导你设置 root 密码、删除匿名用户、禁止 root 远程登录、清理测试数据库一路 y 下来就完事了。如果你装的是 CentOS/RHEL一般会提示先安装 MySQL 官方仓库sudo yum install https://repo.mysql.com/mysql80-community-release-el9.rpm sudo yum install mysql-community-server sudo systemctl start mysqldCentOS 安装后会在日志/var/log/mysqld.log里生成一个临时 root 密码需要先用这个密码登录再修改密码。这也是一道常见笔试题记一下。Linux 的配置文件位置一般是/etc/mysql/my.cnf或/etc/my.cnf如果想自定义字符集或端口就在对应位置添加[mysqld]段落。改完配置需要重启服务sudo systemctl restart mysql。3.2 macOSHomebrew 是省心方案macOS 上如果不想下载奇怪的 dmg 安装包最干净的方式就是 Homebrew。确认电脑上已经装好了 Homebrew 之后执行brew install mysql brew services start mysql装完默认同样是无密码 root先登录进去设置密码mysql -uroot ALTER USER rootlocalhost IDENTIFIED BY 新密码;macOS 的配置文件在/usr/local/etc/my.cnfIntel 芯片或/opt/homebrew/etc/my.cnfApple Silicon修改方式和 Linux 类似。如果装了多版本 MySQL可以用brew services list查看当前运行的服务名称。有一点要注意Apple Silicon 芯片的 Mac 下载安装包时要选 arm64 版本装 Intel 版会导致进程效率下降或者打不开这是很多 Mac 新手踩得最多的坑。4. 安装完成后的基础验证与常用操作4.1 用命令行确认 MySQL 真的能干活安装完成后不要急着去找花里胡哨的图形工具先用命令行验证一下最实在。Windows 按Win R输入 cmd 打开命令行管理员不必要普通权限就行输入mysql --version如果能看到类似mysql Ver 8.0.xx for Win64 on x86_64的输出说明客户端程序能正常工作。然后登录数据库mysql -uroot -p输入密码后如果出现mysql提示符就说明服务端也正常了。在提示符下执行SELECT VERSION(); SHOW DATABASES;这两条命令分别查看版本和当前数据库列表。正常情况你会看到 information_schema、mysql、performance_schema、sys 这几个系统数据库。看到这些恭喜MySQL 已经装好了。这里顺便解释一下登录命令里的参数-u指定用户名-p表示要输入密码-h是指定主机地址-P是指定端口。如果你在本机但连不上可以试试mysql -uroot -p -h127.0.0.1 -P3306这个写法强制走 TCP 协议能绕开一些 socket 文件路径相关的坑。4.2 服务状态和端口检查掌握这三招MySQL 装好了不代表服务一直在运行。Windows 上检查服务状态可以在服务管理器里看 MySQL80 的状态是不是“正在运行”或者在 cmd 里执行sc query MySQL80 netstat -ano | findstr :3306netstat那个命令能看到本机 3306 端口有没有进程在监听如果完全没有输出说明 MySQL 还没启动或者端口被改了。Linux 上检查服务状态用systemctl status mysqld ss -ltn | grep 3306macOS 用brew services list把这些命令都配合起来用就能快速判断服务端是否正常。以后数据库突然连不上的时候第一反应不是去改密码、重启电脑而是先查服务状态和端口这是排查问题的基础。4.3 可视化工具怎么选从自带 Workbench 到开源 DBeaver虽然命令行完全能操作 MySQL但对新手来说图形界面显然更友好。官方自带的是 MySQL Workbench安装 MySQL 的时候一般不会随带需要单独下载。它的优点是官方出品、功能全缺点是比较笨重界面风格偏老。另一个很火的工具是 DBeaver社区版完全免费开源支持 MySQL、PostgreSQL、SQLite、Oracle 等几乎所有常见数据库跨平台界面现代个人强烈推荐。装好之后新建连接时填主机名 127.0.0.1、端口 3306、用户名 root、密码点击测试连接成功就能进去了。还有很多人会问 Navicat 好不好用。Navicat 确实好用但它收费网上很多所谓“破解版”的安装包很多都会捆绑木马或后门极不安全非常不建议碰。数据库里存的都是你辛辛苦苦写的数据因为贪便宜装破解工具导致数据泄露或电脑被入侵代价太大。免费替代方案非常多DBeaver Community、DataGrip有社区版、MySQL Workbench 完全够用。4.4 日常开发最常用的几条 SQL安装后练练手既然装好了顺手练几条最常用的 SQL能帮你验证数据库是不是真的能正常读写。建个测试库建张表插入几条数据再查出来CREATE DATABASE testdb DEFAULT CHARACTER SET utf8mb4; USE testdb; CREATE TABLE users ( id INT AUTO_INCREMENT PRIMARY KEY, name VARCHAR(50) NOT NULL, created_at DATETIME DEFAULT CURRENT_TIMESTAMP ); INSERT INTO users (name) VALUES (Alice), (Bob); SELECT * FROM users;如果这几条语句都能顺利执行说明不仅安装成功连字符集、权限、事务相关的基础配置也都正常。这一套操作以后建真实库表的时候还会用到现在练熟不吃亏。5. 安装常见问题与排查技巧5.1 ERROR 2002Cant connect to local MySQL server through socket /tmp/mysql.sock这个报错在很多 Linux 或者 macOS 上初次启动服务时经常出现新手看到一长串英文很容易慌。简单说mysql客户端默认尝试通过一个叫 socket 的本地文件来连接服务端报这个错一般意味着服务端没启动、socket 路径不对或者权限有问题。排查顺序建议是这样第一步确认服务有没有启动Linux 执行systemctl status mysqlmacOS 执行brew services listWindows 上一般不报这个错因为 Windows 默认走 TCP。第二步如果服务是启动状态但还报错就用强制 TCP 方式连接mysql -uroot -p -h127.0.0.1 -P3306能连上就说明问题出在配置里的 socket 路径查看配置文件里[mysqld]段下的socket参数确认它和[client]段下的socket指向一致。第三步检查/tmp目录权限部分系统会把/tmp权限设置得很严格导致普通用户无法创建 socket 文件可以试试把 socket 改到/var/run/mysqld/目录。顺便说如果你在 Windows 上看到类似错误信息但路径成了C:/xx/mysql.sock那一定是服务没起来或者服务异常退出了优先看 Windows 服务列表和错误日志。5.2 MySQL 服务启动失败先看错误日志无论哪个平台服务启动失败都是新手最容易卡住的地方。遇到这种情况不要瞎猜第一件事是看错误日志。Windows 上MySQL 的错误日志默认在数据目录下一般路径是C:\ProgramData\MySQL\MySQL Server 8.0\Data\里面会有以.err结尾的文件。打开这个文件搜索error或ERROR关键词往往能看到明确的原因比如unknown variable、Cant start server: Bind on TCP/IP port、Permission denied之类。Linux 上用journalctl -u mysqld或直接查vi /var/log/mysqld.log也一样。最常见的启动失败原因有三个第一个是 my.ini 或 my.cnf 里写了不支持的参数比如变量名拼错了MySQL 启动时直接报错第二个是数据目录没有初始化直接用mysqld命令启动后提示找不到系统表第三个是数据目录的权限不够Windows 下目录的读写权限被限制Linux 下当前运行用户对 datadir 没有写权限。解决思路是确保 datadir 存在、为空且权限正确如果是 ZIP 手动初始化过就不该为空再仔细检查配置文件。另外一个容易被忽略的细节是my.ini 文件保存时编码要正确建议保存为 UTF-8 无 BOM 格式。网上很多教程是复制粘贴的复制下来后 Windows 记事本可能会存成带 BOM 的 UTF-8MySQL 解析时把 BOM 当成了字符也会导致启动失败。5.3 忘记 root 密码怎么重置忘记密码是所有人都会遇到的事情不用觉得丢脸。重置思路是先停掉 MySQL 服务然后以跳过权限验证的方式启动 MySQL登录后修改密码再恢复正常模式启动。Windows 上操作相对麻烦一点我给出一个安全且通用的流程。以管理员身份打开 cmd先停止 MySQL 服务net stop MySQL80然后在命令行以跳过授权表的方式前台启动 MySQLmysqld --skip-grant-tables --shared-memory这个窗口不要关它会一直占着。再打开一个新的命令行窗口进入 bin 目录直接执行mysql -uroot此时会无密码登录进 MySQL。在 mysql 提示符下先刷新权限FLUSH PRIVILEGES;然后再使用ALTER USER修改密码从 MySQL 8.0 开始不能再直接改mysql.user表里的authentication_string字段而是要用标准的账户管理语句ALTER USER rootlocalhost IDENTIFIED BY 新密码;改完退出登录然后回到第一个 cmd 窗口按CtrlC停止这个临时进程再用net start MySQL80正常启动服务。这里需要诚实提醒你--skip-grant-tables模式下任何人都可以不输入密码就登录你的数据库非常危险只适合本机紧急恢复用用完立刻恢复正常模式启动。5.4 端口 3306 被占用怎么办安装向导走到最后卡住的时候经常会弹出Port 3306 is already in use之类的提示。这时候先查端口是被谁占用的Windows 执行netstat -ano | findstr :3306最后一列是 PID再执行tasklist | findstr PID号就能看到是哪个进程一般抓出几个常驻进程。如果是历史遗留的 MySQL 进程把它结束掉如果是别的程序占用了 3306那就只能改 MySQL 的端口。改端口很简单在 my.ini/my.cnf 的[mysqld]段里修改port3307保存后重启服务。但要提醒一句不要因为强迫症随随便便改端口端口改动之后所有程序连接数据库的地址都要写对端口不然处处连不上。学习阶段保持默认 3306能少很多麻烦。5.5 字符集乱码、SQL 执行失败这类“半路杀出的问题”如果安装时没有设置字符集在插入中文数据后查询出来很可能是乱码。解决方法是保证三处一致数据库、表、连接的字符集都使用 utf8mb4。创建库的时候可以显式指定CREATE DATABASE mydb DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;连接字符串里也要带上characterEncodingutf8Java或charsetutf8mb4其他客户端。如果还是乱码检查终端本身的编码Windows cmd 的默认编码是 GBK可以用chcp 65001切换成 UTF-8 再连。执行 SQL 时报语法错误最常见的原因是语句结尾忘了写分号或者字符串用了中文引号。MySQL 命令行对分号很敏感只有带分号按回车才执行。还有一些坑是保留字问题比如建表时给字段命名order、group、desc这些系统保留字会直接报错解决办法是尽量别用保留字做字段名非要用就加反引号包起来。写在最后的一点体会装过几十遍 MySQL 之后我最大的感受是这类安装教程最难的不是下载也不是点击 Next而是出错之后的排查思路。大部分新手遇到报错就慌其实 MySQL 的错误日志已经把原因写得明明白白问题只在于你会不会去找它。建议把第 5 部分收藏一下以后忘记密码、连接不上、启动失败的时候翻出来对照一遍能省下大把时间。另外还有一个习惯值得养成每次安装数据库之前先在纸上写下自己规划的端口、root 密码、数据目录位置。这个东西虽然简单但真的能帮你理清思路尤其是当你需要在一台电脑上装多套数据库、或者以后要迁移数据的时候前期规划的价值就体现出来了。如果照着这篇文章安装还是有卡住先冷静下来把报错信息原样复制去搜索绝大多数问题前人早就踩过也早就把答案写好了。希望这篇纯享版教程能帮你顺顺利利完成第一次 MySQL 安装。