MySQL Workbench / Windows 10 兼容性检查与安装
MySQL Workbench 是一个使用 MSI 包安装在 Windows 上的 MySQL 管理客户端。如果您想在 Windows 10 上使用它，首先需要检查您打算安装的版本的操作系统支持情况。当前官方安装手册指定支持 Windows 11 或 Windows Server 2022，因此下载最新的安装包并不意味着支持 Windows 10。
在 Windows 10 上，首先检查支持条件
如果您必须保留与本文Windows 10主题相匹配的旧环境，请单独核实您的组织批准的Workbench版本、该版本支持的操作系统及其安全维护状态。在档案中找到文件并不保证当前的支持或安全。不要将强制在兼容模式下运行不受支持的安装程序视为默认解决方案。
当前的 Workbench Windows 安装手册 列出了 Windows 11 或 Server 2022、.NET Framework 4.5.2 以及 Visual C++ 可再发行组件 2015–2022 作为先决条件。最新下载版本和手册示例中使用的版本可能不同。请检查所选安装程序显示的要求以及发布说明，并从微软的官方分发渠道获取缺失的组件。没有理由的话，您不需要删除已满足要求的运行时或用旧版本替换它。
安装 Workbench 和安装数据库服务器是不同的任务
Workbench 是一个用于连接服务器、运行 SQL（结构化查询语言）语句和建模数据库的客户端。单独安装 Workbench 并不会自动创建 MySQL 服务器服务或服务器帐户。建模可以在没有服务器连接的情况下进行，但执行实际的 SQL 需要正在运行的 MySQL 服务器和连接权限。
如果服务器在此电脑上，请准备本地连接详细信息；如果服务器在其他电脑上，请准备管理员提供的地址、端口、账户以及 TLS 或 SSH 连接策略。TLS（传输层安全性）可以保护网络连接；SSH（安全外壳）在为服务器配置时可以提供安全的连接路径。重新安装 Workbench 不会重置您不知道的服务器密码。通常示例中的本地地址 127.0.0.1 和端口 3306 仅在它们与实际服务器配置匹配时适用。
Workbench 官方介绍描述了其MySQL功能，并指出某些功能的兼容性取决于服务器版本。即使MariaDB连接成功，也不能保证管理、备份或建模功能的兼容性。如果您需要MariaDB工具，请单独检查特定操作和服务器版本。
在官方网站上选择Windows安装程序
- 打开MySQL Workbench社区下载页面。区分它与名称相似的产品，如MySQL Community Server。
- 在 Select Version（选择版本）下检查所需版本，在 Select Operating System（选择操作系统）下检查 Microsoft Windows。Windows (x86, 64 位) 表示 x64 软件包，而不是 32 位安装程序。同时检查 Windows 设置 → 系统 → 关于 下的系统类型。
x64 MSI 文件名示例可以是 mysql-workbench-26.10.0-winx64.msi。将其视为产品、版本、架构和软件包格式的示例，而不是必须找到该确切版本。版本号、下载大小和页面布局可能会更改。Windows 下载列表并不能证明与 Windows 10 的兼容性。
- 为所选文件点击 Download（下载）。如果出现 Oracle 帐户界面，点击“No thanks, just start my download.”链接，可以无需创建帐户即可进行下载。
- 检查下载的文件是否与所选的产品和版本匹配。在文件属性中查看其数字签名，并参考官方网站的包验证指南。不要使用来源无法确认的再分发网站上的安装程序。
MSI 安装向导中该选择什么
以下是Workbench 官方 Windows 安装手册描述的基本独立 MSI 流程。当所选版本支持操作系统且满足其先决条件时继续。在公司电脑上，首先检查安装权限和管理策略。如果已安装其他版本，请保存连接设置、模型文件和打开的 SQL 文件，检查升级条件，并关闭已存在的 Workbench。
- 运行 MSI 并在安装向导中点击 Next（下一步）。如果出现权限提升提示，请检查程序名称、发布者和文件路径是否与您刚下载的软件包一致，然后使用具有安装权限的账户批准。
- 检查安装位置。除非您有部署需求，否则请使用默认位置。对于不同版本，不需要输入手册中的 Workbench 8.0 示例路径。
- 如果提供 Setup Type（安装类型）选项，Complete（完整安装）会安装所有 Workbench 组件，而Custom（自定义安装）则允许您选择组件或安装位置。此处的 Complete并不意味着 MySQL Server 也会被安装。
- 查看摘要并选择 Install（安装）。如果您的版本显示许可条款，请阅读并决定是否同意。安装完成后，选择 Finish（完成）并启动 Workbench。
MySQL安装程序的界面管理多个MySQL产品，与此独立MSI路径不同。独立文件在您只需要Workbench时可以明确目标产品。如果安装报告缺少前提条件，请记录其名称，解决该要求后再试。避免从任意网站下载单个DLL并将其复制到程序文件夹中。
启动Workbench并使用只读查询检查连接
从开始菜单打开 MySQL Workbench。进入其主页意味着应用程序启动成功；但要确认数据库连接成功，还需要另行检查。按照官方连接创建指南，用 MySQL Connections 旁的 + 按钮添加一个连接。
- 在 Connection Name 中输入一个易于识别的连接名称。对于简单的本地网络连接，在 Connection Method 下选择 Standard (TCP/IP)，并输入实际的 Hostname（主机名）、Port（端口）和 Username（用户名）。
- 选择 Test Connection（测试连接）。如果系统要求密码，请输入该服务器账户的密码。对于远程服务器，请使用管理员要求的 TLS 证书验证或 SSH 方法。不要仅为了消除错误而禁用加密或认证。
- 测试成功后，点击 OK（确定）保存并打开连接以进入 SQL 编辑器。输入并执行以下只读语句。如果存在其他语句，请在执行前只选择此语句。
SELECT 1 AS connection_ok;如果结果网格显示 connection_ok 列，且有一行的值为 1，说明请求已到达服务器并返回了结果。此基本检查不会创建或删除表或数据。它不会验证每个管理功能，因此请单独验证实际工作所需的权限。在共享计算机上，不要选择存储密码，并在完成后关闭连接。
区分启动和连接错误，并在需要时卸载
- 程序本身无法打开：首先比较操作系统、架构和运行时要求。安装完成的消息并不意味着在 Windows 10 上可以正常运行。记录完整错误信息和所选择的 Workbench 版本。
- 连接被拒绝或超时：检查服务器是否运行，其地址和端口，以及网络路径，而不是仅关注Workbench 的安装。不要为了修复客户端错误而将数据库端口暴露给整个互联网。
- 访问被拒绝：检查服务器的账户名称、密码以及连接来源的权限。Windows 登录密码和 MySQL 账户密码是独立的凭证。
- 版本或功能兼容性警告：即使连接正常，也请查阅发布文档以了解特定的管理操作。不要仅因为出现警告就立即更改生产服务器的版本。
如果未完成的安装提供 Cancel（取消）选项，请使用该选项停止安装。要删除已安装的副本，请关闭 Workbench，并使用 Windows 10 设置 → 应用 → 应用和功能，选择 MySQL Workbench，然后卸载它。不要同时删除其他产品，如 MySQL 服务器。
删除 Workbench 与删除服务器数据是分开的，连接设置或个人模型和 SQL 文件可能会保留。请在删除前保留所需的文件，并在重新安装后单独决定是否重用之前的设置。
