一、基础环境配置
本文档基于本地实际操作整理，核心环境配置如下，与网络通用方案基本一致，重点补充关键差异点与问题解决方案：
MySQL 驱动：本地使用 MySQL 8.0 文件编译生成的驱动
Qt 版本：5.14.2
目标数据库：MySQL 5.7（密码加密编码为 sha2_password）
二、必须遵守的核心规则
文件夹命名硬性要求
本地 MySQL 安装文件夹与 Qt 安装文件夹，严禁包含中文、空格及特殊字符，具体说明如下：
规则性质：此为 “必须遵守” 的硬性要求，而非 “建议规避” 的优化项。
违规后果：
即使在 Qt 控制面板中能正常识别到 MySQL 编译后的驱动，项目运行时仍会出现 “无法找到驱动” 的错误；
即便在项目代码中手动写死 MySQL 驱动的加载目录，也无法解决该问题，最终导致数据库连接失败。
三、当前已遇问题汇总
截至目前，本地实践中仅发现上述 “文件夹命名违规导致驱动加载失败” 的核心问题，后续若遇到新问题将补充更新。
