Windows用户下载MySQL Workbench Community免费版；macOS用户需匹配系统版本及芯片架构，遇“unidentified developer”提示右键打开即可；Workbench仅为客户端，须确保本地MySQL服务运行、密码正确且允许本地连接。
MySQL Workbench 下载和安装选哪个版本
Windows 用户直接去官网下 MySQL Workbench Community（免费开源版）就行，别碰 Commercial 版——它要 License，而且日常建模、查表、写 SQL 完全用不上。macOS 用户注意：从 8.0.34 开始，Workbench 不再支持 macOS 10.15 以下系统；M1/M2 芯片选 ARM64 包，别错装成 x86_64，否则打不开。
常见错误现象：“The application cannot be opened because it is from an unidentified developer”（macOS）。解决方法不是关掉系统防护，而是右键 App → “打开”，点一次确认即可。
连接 MySQL 服务前必须确认的三件事
Workbench 本身不带 MySQL 服务，它只是个客户端。你本地得先有正在运行的 MySQL 实例，否则连不上任何东西。
- 检查 MySQL 是否在运行：
sudo systemctl status mysql（Linux），或看 Windows 服务里有没有MySQL80服务且状态是“正在运行” - 确认 root 密码是否还记得——如果用
mysql_secure_installation初始化过，密码就不是空的；如果忘了，得进安全模式重置，Workbench 连不上时别急着重装 - 确认 MySQL 允许本地连接：
bind-address在/etc/mysql/mysql.conf.d/mysqld.cnf（Linux）或my.ini（Windows）里不能是127.0.0.1以外的地址（比如0.0.0.0会暴露端口，不推荐）
新建连接时 host 和 port 填错的典型表现
填 localhost 和 127.0.0.1 看似一样，但在 MySQL 权限体系里它们可能对应不同用户记录。比如你创建了 'root'@'localhost'，但 Workbench 连接时填了 127.0.0.1，就会报 Access denied for user 'root'@'127.0.0.1'。
实操建议：
解析 MySQL 8.0 的 DDL 脚本，并将表结构导出为 Excel 格式。适用于用户需将 MySQL 的 `CREATE TABLE` 语句转换为结构化的 Excel 文件场景，导出内容包含字段名、数据类型、长度及精度等信息。支持多张表的批量处理，每张表对应 Excel 中的一个独立工作表。适用于数据库文档编写、数据字典生成及模式分析等任务。
- 优先填
127.0.0.1，避免 Unix socket 和 TCP 混淆 - port 默认是
3306，改过端口的务必核对SHOW VARIABLES LIKE 'port';的返回值 - 如果用 Docker 启的 MySQL，host 别填
localhost——容器内 localhost 是它自己，宿主机要用host.docker.internal（macOS/Windows）或宿主机 IP（Linux）
首次打开 Workbench 提示“SSL connection is required”怎么办
这是 MySQL 8.0.28+ 默认开启 SSL 强制策略后，Workbench 没配好导致的。不是 bug，也不是必须开 SSL 才能用。
解决路径很直白：
- 连接配置页 → “SSL” 标签 → 把
Use SSL改成Disabled - 或者更稳妥点：在 “Advanced” 里加参数
allowPublicKeyRetrieval=true&useSSL=false到Others输入框 - 如果公司环境真要启用 SSL，别手动导证书，用
mysql_ssl_rsa_setup生成一套标准 PEM 文件再指向它们
容易被忽略的是：这个提示只在第一次连接时弹窗，之后失败就静默断开，连错误日志都不打——所以连不上又没报错，先回头检查 SSL 设置。
