MySQL Workbench 是官方配套 MySQL 数据库的图形化管理工具，安装完成之后，需要先保证本机或者远程的 MySQL 数据库服务处于启动状态，再打开 Workbench 软件，建立数据库连接，就可以执行 SQL 语句管理数据库，很多新手运行失败，本质都是 MySQL 服务没启动，或者连接参数填写错误，软件本身只是客户端，不能脱离 MySQL 服务单独工作。它分为可视化建模，SQL 开发，服务器管理三大模块，日常说的运行，大多是指打开软件并成功连上 MySQL 实例，运行 SQL 脚本或者查询语句，也包含软件本身的启动运行，下面从前期准备，软件启动，连接数据库，运行 SQL，常见报错排查逐层说明。
前期必备准备
| 项目 | 说明 |
|---|---|
| MySQL 服务 | 本地安装的 MySQL 必须启动，Windows 在服务列表，Linux 使用 systemctl 启动，远程库需要网络通，账号有权限 |
| MySQL Workbench | 已经完成安装，Windows 是 exe 安装包，mac 是 dmg，Linux 有 deb 或者 rpm 包 |
| 连接信息 | 主机地址，端口默认 3306，用户名，密码，提前确认 |
第一步 启动 MySQL Workbench 软件
Windows 系统，在开始菜单找到 MySQL Workbench 图标，双击打开，也可以桌面快捷方式双击启动。mac 系统在启动台或者应用程序文件夹找到 MySQL Workbench 点击运行。Linux 可以在应用菜单点击，也可以终端输入 mysql-workbench 回车启动。
启动之后会进入主界面，主界面会展示已经保存过的数据库连接，也就是 Saved Connections，如果是第一次打开，这里是空的。
第二步 创建数据库连接
1 点击主界面加号按钮，新建连接
2 填写连接名称，可以自定义，比如本地 MySQL
3 Hostname 填写localhost代表本机，如果是远程服务器就填写服务器 IP
4 Port 默认填写 3306，修改过端口就填实际端口
5 Username 填写数据库账号，一般 root
6 Password 可以点击 Store in Vault 保存密码
7 点击 Test Connection 测试连接，提示成功就代表参数没问题，点击 OK 保存这个连接
第三步 运行 SQL 查询
1 双击已经保存好的连接，进入 SQL 编辑窗口
2 在空白编辑区输入 SQL 语句，比如 select version ();
3 点击闪电形状的 Execute 按钮，或者快捷键 Ctrl+Enter，就会运行这条 SQL
4 下方 Result Grid 区域就会展示查询返回结果，消息面板会提示运行成功或者报错信息
如果是运行整个 sql 脚本文件，可以点击 File 菜单，Open SQL Script，打开外部 sql 文件，再点击闪电执行全部语句。
第四步 服务器管理模块运行
主界面还有 Server Administration 模块，这里可以启动停止 MySQL 服务，查看状态，备份还原数据库，查看日志，修改配置文件 my.ini 或者 my.cnf，这个模块需要对应的连接拥有管理员权限。
深度注意要点
Workbench 只是客户端程序，它本身不内置 MySQL 数据库服务，如果只装 Workbench 没有安装 MySQL 服务，打开软件之后连接一定会失败，这是新手最容易混淆的点。本地 MySQL 服务如果没有自启动，每次开机都要手动启动 MySQL 服务，否则 Workbench 能打开，但是连不上库。
远程连接场景，要确认服务器防火墙放行 3306 端口，MySQL 账号允许远程访问，也就是授权 host 不是localhost，否则会报拒绝连接错误。
版本匹配建议 Workbench 版本尽量和 MySQL 主版本接近，跨大版本容易出现兼容报错，比如 Workbench8.0 搭配 MySQL5.7 部分功能会异常。
结论
MySQL Workbench 运行的核心流程就是先启动 MySQL 数据库服务，再打开 Workbench 客户端，新建或者打开数据库连接，之后就可以在 SQL 编辑器执行 SQL 语句，也可以使用建模和服务器管理功能，只要连接参数正确，网络和权限正常，就可以正常运行使用。
【常见问题】
问题 1 MySQL Workbench 打开软件成功但是运行连接时报错 Can't connect to MySQL server 怎么办
回答 1 优先检查 MySQL 服务有没有启动，确认端口是不是 3306，核对主机地址，远程环境检查防火墙，确认 MySQL Workbench 填写的连接参数和实际 MySQL 实例一致。
问题 2 MySQL Workbench 运行 SQL 之后没有结果是什么原因
回答 2 确认 SQL 语句已经选中，点击的是执行选中语句还是全部执行，检查 SQL 语法是否正确，查看下方消息栏报错，很多时候是表不存在或者权限不足导致 MySQL Workbench 运行查询无返回。
问题 3 可以直接用 MySQL Workbench 单独运行不需要 MySQL 服务吗
回答 3 不可以，MySQL Workbench 只是图形客户端，本身不包含数据库引擎，必须提前运行 MySQL 数据库服务，MySQL Workbench 才可以连接并执行数据库相关操作。
问题 4 Linux 终端输入命令运行 MySQL Workbench 提示 command not found 怎么处理
回答 4 检查 MySQL Workbench 是否完成安装，确认安装包安装成功，把程序路径加入系统环境变量，或者直接进入安装目录执行程序，保证 MySQL Workbench 可执行文件可以被系统识别。
【免责申明】
本文内容仅作为 MySQL Workbench 操作学习参考，操作过程涉及数据库连接，SQL 执行，服务启停等操作，请提前做好数据库备份，错误操作可能造成数据丢失，本文不对任何数据损坏，业务故障等后果承担责任，请在测试环境优先练习。
