不吃章鱼烧在正式开始前说一句：这篇写给你，不是写给搜索引擎，而是写给被安装向导卡住、被黑窗口报错吓到的新手。我们从零开始，把 MySQL 下载安装、Workbench 连接、环境变量、基础 SQL 这条链路一次性走通。
1. 装之前先想清楚：MySQL Server 和 Workbench 是两回事
很多新手打开教程，看到“安装 MySQL”就以为下载一个 MySQL Workbench 就完事了。等到装完连不上、命令行打不开，才发现自己连装的是什么东西都没搞明白。所以第一步，请先搞清楚这一对关系。
1.1 MySQL Server 管数据，Workbench 管界面
MySQL 整个体系里，真正干活的是一个叫 MySQL Server 的数据库服务。它负责存储数据、解析 SQL、处理事务、维护索引，没有它，你的数据就没有地方去。而 MySQL Workbench 只是官方提供的一个可视化客户端，你可以把它理解成一个“操作面板”，用它写 SQL、看表格、设计模型，都很方便。
打一个贴近生活的比方：MySQL Server 是餐厅的后厨，Workbench 是前厅的点餐平板。平板再好看，后厨没开火也上不了菜。换句话说，如果你只装了 Workbench，没有装 MySQL Server，打开 Workbench 想建连接时，一定会报错，因为根本没有服务在等你连接。
我为什么要把这个问题放在最前面？因为我见过太多人把“下载 MySQL Workbench”等同于“安装 MySQL”。这会导致后面所有排查都走偏。正确的认识是：你至少需要把 MySQL Server 装好、启动起来，再用 Workbench 去连它。如果你的目的是学和开发，一般还会顺便把 Workbench 装上，方便操作。
1.2 下载版本怎么选：Installer、ZIP 包、版本号
先给结论：Windows 用户下载安装时，选 MySQL Community Server 8.0 的 MSI Installer 安装包，而不是 ZIP 解压版。
说原因。MySQL 官网下载分成几个入口，新手最容易选懵。你需要的路径大致是“DOWNLOADS → MySQL Community (GPL) Downloads → MySQL Installer for Windows”。在这个页面里，官方提供了两种安装包：
- mysql-installer-community-8.0.x.msi——几十到几百兆的图形安装向导。双击之后，想装哪个组件勾哪个组件，Server、Workbench、连接器都能管理。这是省心路线。
- mysql-8.0.x-winx64.zip——免安装的压缩包。看着清爽，实际上更麻烦。解压后没有 data 数据目录，要用命令行先执行初始化，还要手动注册 Windows 服务，环境变量也得自己配。新手一旦走这条路线，很容易卡在“明明解压了，但服务起不来”。
至于版本号，你用 8.0 系列就对了。有些课程还讲 5.7，基础 SQL 语法差别不大，但安装配置方式已经截然不同。网上那些“mysql workbench 8.0.30 安装失败”的热搜，就是 8.0.30 这个具体版本的安装问题，下面会细说。
1.3 安装失败的高频原因：权限、运行库、中文路径
先打个预防针。你在下载安装时大概率会遇到一次失败，比如搜到很多人吐槽“The action 'install' for product 'mysql workbench 8.0.30' failed”。
我处理过不少这种问题，绝大多数逃不开三个原因：
第一，安装程序没有以管理员身份运行。Windows 对 Program Files 目录写入有保护，右键安装包，选择“以管理员身份运行”，很多玄学问题就没了。
第二，系统缺少 Visual C++ Redistributable。Workbench 是 C++ 写的，依赖微软的 Visual C++ 运行库。如果系统里没有，安装向导会在最后一步报失败。解决方法是先去微软官方下载 vc_redist.x64.exe 装一遍，再回头装 MySQL。
第三，安装路径里带了中文或空格过长的目录。虽然 MySQL 官方安装包默认装在 C:\Program Files\MySQL\，这个路径本身有空格但没问题，但如果你手动改成像 D:\软件\MySQL\ 这种路径，后续初始化服务时非常容易报错。建议直接保持默认路径，省心。
还有一个容易被忽略的事：如果下载的是在线安装版（installer 体积只有几 MB），安装全程需要联网拉组件。网络一抖，中间某个组件下载失败，安装进程就会回滚报错。所以优先下载那个几百 MB 的离线完整包，避免网络引起的未知问题。
需要模型API调用？ 免费领10W Token，多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. 安装向导里真正决定成败的几个选择项
安装包没问题之后，安装向导本身也藏着几个坑。新手容易全程“下一步”点到结束，等发现连不上，再回头看已经晚了。下面我把关键选项逐个拆开。
2.1 安装类型：别图省事选 Full，Custom 更可控
当安装向导出现“Choosing a Setup Type”时，里面有几个选项：Developer Default、Server only、Client only、Full、Custom。很多人默认选第一个 Developer Default，因为描述是“开发机常用”。但 Developer Default 会连带安装 MySQL Shell、Connectors、Documentation 等一堆组件，体积大、耗时长，而且某一个组件失败会导致整个安装失败。
我的做法是选 Custom，自己只勾三个必需项：
- MySQL Server 8.0.x（这是核心）
- MySQL Workbench 8.0.x（可视化操作界面）
- MySQL Connectors 可以先不装；到后面做 Java/Python 连数据库时，再用 Installer 补装也不迟
这里多说一句，如果你不小心在安装时漏掉了 Workbench，不需要重装 Server。回到官网单独下 MySQL Workbenc