1. 为什么还要聊 MySQL 8.0.19 这个“老版本”
你可能觉得奇怪，MySQL 都出到 8.4 甚至 9.x 了，怎么还有人专门写 8.0.19 的安装教程？我一开始也这么想，直到去年帮一个做企业内部管理系统的团队排查环境问题，才发现这个版本在不少实际项目里仍然是“钉子户”。原因很实在：很多公司的测试环境、生产环境、甚至某些行业软件的依赖包，都锁死在 8.0.19 这个版本上。你本地用最新版跑得好好的，一部署上去就报错，这种亏吃过一次就够了。
所以这篇内容就是写给那些需要在本机搭建与线上完全一致的 MySQL 8.0.19 环境的人看的。不管你是刚入行的后端开发、正在做数据库课程设计的学生，还是需要本地复现某个数据问题的测试人员，只要你的目标环境是 8.0.19，那跟着这篇走就能少踩很多坑。我会把 Windows 和 macOS 两个平台的安装流程都讲清楚，重点放在版本对齐、初始化配置、Workbench 连接、以及建库建表时的字符集陷阱这几个最容易出问题的地方。
先明确一个核心原则：数据库版本、客户端工具版本、字符集配置，这三者必须作为一个整体来考虑。很多人装完 MySQL 就用默认的 Workbench 去连，结果中文乱码、时间字段报错、远程连不上，其实都是因为把这三件事割裂开来处理了。下面我会按照“先想清楚为什么，再动手做”的顺序，把每个环节拆开讲。
2. 安装前的整体规划与版本选择逻辑
2.1 为什么锁定 8.0.19 而不是更新的小版本
MySQL 8.0 系列从 8.0.0 到 8.0.40 之间有很多次改动，其中 8.0.19 是一个比较特殊的节点。它在 2020 年初发布，属于 8.0 早期版本中相对稳定、且被大量中间件和 ORM 框架验证过的一个版本。我遇到过好几次这样的情况：某个项目用的连接池版本比较老，连 MySQL 8.0.30 没问题，但连 8.0.19 时握手协议有细微差异，导致连接超时。反过来也一样，有些老系统只认 8.0.19 的认证插件行为。
从实操角度说，如果你没有明确的版本锁定需求，直接用最新的 8.0.x 或 8.4 LTS 当然更好。但如果你像我一样，需要复现一个特定环境，那就老老实实装 8.0.19。这里有个判断标准：打开你项目的pom.xml、package.json或者requirements.txt，看看数据库驱动版本，再去查这个驱动官方文档里标注的兼容 MySQL 版本范围。如果范围里包含 8.0.19，那装这个版本就是最稳妥的。
2.2 安装包类型怎么选：MSI、ZIP 还是 DMG
Windows 平台上，MySQL 官方提供两种主要安装包：MSI 安装器和ZIP 压缩包。MSI 的好处是图形化引导，自动配置服务、环境变量、数据目录，适合不想折腾的人。ZIP 包则是“绿色版”，解压后手动初始化，适合需要多版本共存或者想完全掌控配置文件的场景。
我个人的习惯是：主力开发机用 MSI，因为省事；测试机或者需要同时装多个版本时用 ZIP。ZIP 包虽然多几步手动操作，但好处是卸载时直接删目录就行，不会在系统里留一堆注册表垃圾。macOS 上则是 DMG 安装包和 TAR 包两种，DMG 双击安装，TAR 包解压后手动配置，逻辑和 Windows 类似。
Workbench 这边相对简单，它就是一个客户端工具，版本号跟 MySQL 服务器保持一致就行。8.0.19 的 Workbench 连 8.0.19 的服务器，基本不会出现兼容性问题。如果你用更高版本的 Workbench 去连 8.0.19，大部分功能正常，但某些新特性面板可能会报错，所以还是建议版本对齐。
2.3 安装前的系统检查清单
动手之前，先花两分钟确认这几件事，能省掉后面很多麻烦：
- 磁盘空间：MySQL 8.0 的数据目录初始就要 200MB 左右，加上日志和后续数据增长，建议至少留 2GB。Workbench 本身不大，200MB 足够。
- 端口占用：默认端口 3306，先跑一下
netstat -ano | findstr 3306（Windows）或lsof -i :3306（macOS），看看有没有被占用。如果被占了，要么改端口，要么先把占用进程停掉。 - 管理员权限：Windows 上安装服务需要管理员权限，macOS 上安装到
/usr/local目录也需要 sudo。提前准备好，别装到一半卡住。 - 旧版本清理：如果之前装过其他版本的 MySQL，先把服务停掉，数据备份好。特别是数据目录，不同版本的数据文件格式可能不兼容，不要直接混用。
注意：如果你之前用 ZIP 包解压过 MySQL 但没配置成功，一定要把残留的
my.ini或my.cnf删干净，否则新安装的实例可能会读取到旧配置，导致启动失败。
3. Windows 平台完整安装与配置实录
3.1 MSI 安装器的逐步操作与关键选项
下载好mysql-installer-community-8.0.19.0.msi之后，双击运行。第一步是选择安装类型，这里有几个选项：Developer Default、Server only、Client only、Full、Custom。我建议选 Custom，因为 Developer Default 会装一堆你可能用不到的东西，比如示例数据库、Excel 插件等，拖慢安装速度。
进入 Custom 之后，在左侧列表里找到 “MySQL Server” 和 “MySQL Workbench”，把它们移到右侧。注意版本号要选 8.0.19，安装器有时候会默认勾选最新版，手动改一下。接下来是安装路径，默认在C:\Program Files\MySQL\MySQL Server 8.0，如果你 C 盘空间紧张，可以改到其他盘，但路径里不要有中文和空格，这是很多奇怪问题的根源。
安装过程本身没什么好说的，一路 Next 就行。真正关键的是安装完成后的配置向导，这里有几个坑：
- Config Type：选 “Development Computer”，它会根据你的机器配置自动分配内存。如果你机器内存小于 8GB，选这个就行；如果内存很大且专门做数据库测试，可以选 “Server Computer” 手动调大缓冲池。
- Authentication Method：这是 8.0 版本最大的变化点。它提供两种：强密码加密（SHA256）和传统加密（mysql_native_password）。如果你的项目里用的驱动比较老，比如 MySQL Connector/J 5.x，那必须选传统加密，否则连不上。选强密码加密的话，后续可以用
ALTER USER改，但不如一开始就选对。 - Root 密码：设一个你记得住的，别搞太复杂。本地开发环境而已，安全性和便利性要平衡。我一般用
Root@123456这种，既满足复杂度要求，又不会忘。 - Windows Service：勾选 “Configure MySQL Server as a Windows Service”，服务名默认
MySQL80。这样开机自启，不用每次手动开。
配置向导跑完之后，它会自动启动服务并做一次连接测试。如果测试通过，说明服务器端没问题了。
3.2 ZIP 包手动初始化的完整命令流程
如果你选的是 ZIP 包，流程会多几步，但每一步都更透明。假设你解压到了D:\mysql-8.0.19-winx64，接下来这样做：
第一步，在解压目录下新建一个my.ini文件，内容如下：
[mysqld] basedir=D:\mysql-8.0.19-winx64 datadir=D:\mysql-8.0.19-winx64\data port=3306 character-set-server=utf8mb4 collation-server=utf8mb4_unicode_ci default-authentication-plugin=mysql_native_password [client] port=3306 default-character-set=utf8mb4这里有几个点要解释。basedir和datadir必须用绝对路径，而且datadir目录不要手动创建，初始化命令会自动生成。character-set-server设成utf8mb4是为了支持完整的 Unicode，包括 emoji 和生僻字。default-authentication-plugin设成mysql_native_password是为了兼容老驱动，前面说过了。
第二步，以管理员身份打开命令提示符，进入bin目录，执行初始化：
mysqld --initialize --console这个命令会生成数据目录并创建一个临时 root 密码，密码会直接打印在控制台里，一定要复制下来。如果你不小心关了窗口，那就只能删掉data目录重新初始化。
第三步，安装服务并启动：
mysqld --install MySQL80 net start MySQL80第四步，用临时密码登录并修改密码：
mysql -u root -p输入临时密码后，执行：
ALTER USER 'root'@'localhost' IDENTIFIED BY 'Root@123456'; FLUSH PRIVILEGES;到这里，ZIP 包的安装就完成了。相比 MSI，多了一步手动写配置和初始化，但你对整个环境的掌控力更强。
3.3 环境变量配置与命令行验证
不管用哪种方式安装，都建议把 MySQL 的bin目录加到系统环境变量Path里。这样在任何目录下都能直接敲mysql命令，不用每次都切到安装目录。
配置完之后，打开一个新的命令行窗口，验证一下：
mysql --version应该输出mysql Ver 8.0.19 for Win64 on x86_64 (MySQL Community Server - GPL)。然后尝试登录：
mysql -u root -p输入密码后如果能看到mysql>提示符，说明服务器和客户端都正常了。这时候可以顺手看一下字符集配置：
SHOW VARIABLES LIKE 'character%';确认character_set_server和character_set_database都是utf8mb4。如果不是，检查my.ini是否被正确加载。
实操心得：Windows 上环境变量修改后，必须重新打开命令行窗口才会生效。我见过有人改完变量直接在旧窗口里试，然后说“没用”，其实是窗口没刷新。
4. macOS 平台安装与 Workbench 连接配置
4.1 DMG 安装包的操作要点
macOS 上安装 MySQL 8.0.19，下载mysql-8.0.19-macos10.15-x86_64.dmg（根据你的系统版本选对应的包）。双击挂载后，会看到一个 pkg 安装包，双击运行。
安装过程中有一个关键步骤：它会弹出一个临时 root 密码，格式类似;hklsdf90*Kls。这个密码只显示一次，一定要复制保存。如果你手快点了继续，那就只能通过重置密码流程来找回，比较麻烦。
安装完成后，MySQL 会出现在系统偏好设置里，可以图形化启动和停止服务。但更推荐用命令行：
sudo /usr/local/mysql/support-files/mysql.server start sudo /usr/local/mysql/support-files/mysql.server stop登录和改密码的流程和 Windows 一样：
/usr/local/mysql/bin/mysql -u root -p输入临时密码后，执行ALTER USER修改成你记得住的密码。
4.2 Workbench 安装与首次连接
Workbench 的 DMG 安装很直接，拖进 Applications 文件夹就行。首次打开时，它会让你创建一个连接。点击 “+” 号，填写：
- Connection Name：随便起，比如
Local-8.0.19 - Hostname：
127.0.0.1 - Port：
3306 - Username：
root - Password：点 “Store in Keychain” 输入你改过的密码
点 “Test Connection” 测试。如果报错Authentication plugin 'caching_sha2_password' cannot be loaded，说明服务器端用了强密码加密，而 Workbench 的驱动没适配。解决办法是在服务器端执行：
ALTER USER 'root'@'localhost' IDENTIFIED WITH mysql_native_password BY 'Root@123456'; FLUSH PRIVILEGES;然后再测试连接，应该就通了。
4.3 连接失败的常见原因速查
| 报错信息 | 可能原因 | 解决办法 |
|---|---|---|
| Can't connect to MySQL server on '127.0.0.1' | 服务没启动 | 检查服务状态，启动 MySQL |
| Access denied for user 'root'@'localhost' | 密码错误 | 重置密码或确认密码 |
| Authentication plugin cannot be loaded | 认证插件不兼容 | 改为 mysql_native_password |
| Unknown database 'xxx' | 数据库不存在 | 先创建数据库 |
| Communications link failure | 端口被占用或防火墙拦截 | 检查端口和防火墙设置 |
这张表建议截图保存，下次遇到问题直接对照排查，比盲目搜索快得多。
5. 数据库创建与字符集避坑指南
5.1 创建数据库的标准语句与参数解释
连接上之后，第一件事就是建库。很多人随手写CREATE DATABASE mydb;，然后后面插入中文就乱码。正确的写法应该是：
CREATE DATABASE mydb DEFAULT CHARACTER SET utf8mb4 DEFAULT COLLATE utf8mb4_unicode_ci;为什么用utf8mb4而不是utf8？因为 MySQL 里的utf8其实是“阉割版”，最多只支持 3 字节的字符，存不了 emoji 和一些生僻汉字。utf8mb4才是真正的完整 UTF-8。排序规则用utf8mb4_unicode_ci而不是utf8mb4_general_ci，是因为前者对多语言排序更准确，虽然性能略低一点点，但在本地开发环境完全无感。
建完之后验证一下：
SHOW CREATE DATABASE mydb;确认输出的字符集和排序规则和你设置的一致。
5.2 用户权限分配与远程访问配置
本地开发通常直接用 root，但如果你要模拟生产环境，最好建一个专用用户：
CREATE USER 'devuser'@'localhost' IDENTIFIED BY 'Dev@123456'; GRANT ALL PRIVILEGES ON mydb.* TO 'devuser'@'localhost'; FLUSH PRIVILEGES;如果需要在局域网内其他机器访问，把localhost改成%：
CREATE USER 'devuser'@'%' IDENTIFIED BY 'Dev@123456'; GRANT ALL PRIVILEGES ON mydb.* TO 'devuser'@'%'; FLUSH PRIVILEGES;但要注意，%表示允许任何 IP 连接，本地开发无所谓，如果是在公司内网，最好限制具体网段，比如'devuser'@'192.168.1.%'。
注意：MySQL 8.0 默认绑定
127.0.0.1，如果要允许远程连接，还需要在my.ini或my.cnf里把bind-address改成0.0.0.0，然后重启服务。这一步很多人会忘，导致明明用户权限给了，还是连不上。
5.3 建表时的字段类型与索引建议
建库之后就是建表。这里不展开讲完整的表设计，只说几个和 8.0.19 相关的细节：
- 主键用
BIGINT UNSIGNED AUTO_INCREMENT，别用INT，除非你确定数据量不会超过 21 亿。 - 字符串字段根据实际长度选
VARCHAR，不要一律用TEXT，TEXT不能有默认值，而且索引效率低。 - 时间字段用
DATETIME还是TIMESTAMP？TIMESTAMP有时区转换，DATETIME没有。本地开发建议用DATETIME，避免时区问题。 - 索引命名要有规律，比如
idx_表名_字段名，方便后续维护。
一个简单的示例：
CREATE TABLE users ( id BIGINT UNSIGNED NOT NULL AUTO_INCREMENT, username VARCHAR(64) NOT NULL, email VARCHAR(128) NOT NULL, created_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP, PRIMARY KEY (id), UNIQUE KEY idx_users_username (username), KEY idx_users_email (email) ) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci;建完之后用SHOW CREATE TABLE users;检查一下，确认字符集和引擎都正确。
6. 常见问题排查与实操经验汇总
6.1 服务启动失败的几种典型情况
MySQL 服务启动失败是最常见的问题，表现是net start MySQL80报错或者服务列表里状态是“已停止”。排查思路按这个顺序来：
第一，看错误日志。数据目录下有个.err文件，比如D:\mysql-8.0.19-winx64\data\DESKTOP-XXX.err，里面会写具体原因。常见的包括端口被占用、数据目录权限不足、配置文件语法错误。
第二，检查端口。netstat -ano | findstr 3306，如果被其他进程占了，要么改 MySQL 端口，要么停掉那个进程。
第三，检查数据目录。如果之前初始化过又删了部分文件，可能导致数据目录不完整。解决办法是清空data目录重新初始化，但这样会丢失所有数据，所以只适用于全新安装。
第四，检查配置文件。my.ini里路径写错、参数拼错都会导致启动失败。可以先用mysqld --validate-config验证配置文件语法。
6.2 中文乱码的根因分析与彻底解决
中文乱码的本质是客户端、连接、服务器、数据库、表、字段这六个层级的字符集不一致。只改其中一层没用，必须全部对齐到utf8mb4。
排查步骤：
- 服务器层：
SHOW VARIABLES LIKE 'character_set_server';应该是utf8mb4。 - 数据库层：
SHOW CREATE DATABASE mydb;确认字符集。 - 表层：
SHOW CREATE TABLE users;确认字符集。 - 连接层：
SHOW VARIABLES LIKE 'character_set_client';和character_set_connection都应该是utf8mb4。
如果连接层不对，可以在连接字符串里加参数，比如 JDBC 的?useUnicode=true&characterEncoding=utf8，或者执行SET NAMES utf8mb4;。
实操心得：我遇到过一种情况，服务器和数据库都是
utf8mb4，但用 Workbench 插入中文还是乱码。后来发现是 Workbench 的默认连接字符集设置问题，在连接配置的 “Advanced” 标签页里把 “Character Set” 改成utf8mb4就好了。这种细节官方文档不会专门写，只能靠踩坑积累。
6.3 版本升级与降级时的注意事项
如果你本地已经装了其他版本的 MySQL，想换成 8.0.19，不要直接覆盖安装。正确做法是：
- 用
mysqldump把现有数据库导出成 SQL 文件。 - 停止并卸载旧版本服务。
- 安装 8.0.19。
- 导入 SQL 文件。
降级更麻烦，因为 MySQL 不支持跨大版本降级。8.0 的数据文件不能直接被 5.7 读取。如果非要降级，只能用逻辑备份的方式：在 8.0 里导出 SQL，然后在 5.7 里导入。注意 8.0 的某些语法（比如窗口函数、CTE）在 5.7 里不支持，导出前要确认兼容性。
6.4 Workbench 使用中的效率技巧
最后分享几个 Workbench 的实用技巧，能明显提升日常操作效率：
- 快捷键：
Ctrl+Enter执行当前语句，Ctrl+Shift+Enter执行所有语句，Ctrl+/注释选中行。 - 保存常用查询：把经常用的 SQL 保存成
.sql文件，下次直接打开，不用重新敲。 - 导出结果集：查询结果可以直接导出成 CSV 或 JSON，在结果网格右上角有个导出按钮。
- 查看执行计划：在查询语句前加
EXPLAIN，然后点 “Execution Plan” 按钮，可以图形化看到索引使用情况。
这些技巧看起来小，但每天省几分钟，一年下来就是几十个小时。我自己最常用的就是Ctrl+Enter和保存查询文件，基本离不开。
踩过几次坑之后，我最大的体会是：数据库环境搭建这件事，版本对齐比什么都重要。不要觉得“差不多就行”，8.0.19 和 8.0.20 之间可能就有一个认证插件的差异，让你排查半天。把版本、字符集、认证方式这三件事在一开始就定死，后面能省掉 80% 的奇怪问题。
