HeidiSQL高DPI环境下自动补全窗口尺寸异常问题分析

问题现象

在HeidiSQL数据库管理工具中，用户报告了一个与高DPI显示环境相关的界面异常问题。具体表现为：当软件运行在多显示器且不同缩放比例的环境中时，自动补全建议窗口的尺寸会随着每次软件重启而逐渐缩小。

环境背景

该问题主要出现在以下配置环境中：

• 操作系统：Windows 10/11
• 显示配置：多显示器设置，各显示器使用不同的缩放比例（如250%、150%等）
• HeidiSQL版本：12.7.0.6872及附近版本

技术分析

根本原因

经过开发团队分析，该问题的核心在于DPI缩放处理机制存在双重计算问题：

1. 自动补全窗口本身具有独立的DPI缩放处理逻辑
2. 应用程序全局也维护了一套DPI感知的尺寸存储/恢复机制

这两种缩放机制叠加导致了尺寸计算的异常，特别是在显示器间移动窗口时，缩放比例的变化会触发不正确的尺寸调整。

影响范围

该问题不仅影响自动补全窗口，还会波及：

• 查询编辑器部分的字体缩放
• 结果展示区域的显示比例
• 其他面板组件的尺寸保持

解决方案

开发团队通过以下方式解决了该问题：

1. 移除了自动补全窗口的独立DPI缩放处理
2. 统一使用应用程序全局的DPI感知机制
3. 增强了窗口尺寸的持久化存储逻辑

用户应对措施

对于遇到类似问题的用户，可以采取以下步骤：

1. 更新到最新版本的HeidiSQL
2. 手动调整自动补全窗口到合适尺寸后，该尺寸将被正确保持
3. 如需重置所有面板尺寸，可使用"工具 > 重置面板尺寸"功能

技术启示

该案例揭示了Windows高DPI环境下GUI开发的一些重要注意事项：

1. 应避免多层级的DPI缩放处理
2. 窗口位置和尺寸的持久化需要考虑显示器缩放因素
3. 在多显示器环境下，需要正确处理不同缩放比例间的切换

后续改进

虽然当前版本已解决主要问题，但仍有以下改进空间：

1. 自动补全窗口在暗色主题下的尺寸调整手柄可见性问题
2. 更智能的初始尺寸计算算法
3. 增强对极端缩放比例(如250%以上)的支持

这个问题展示了现代GUI开发在高DPI和多显示器环境下面临的挑战，也为同类软件的开发提供了有价值的参考。