编程GUI到底什么是DPI —— Windows 平台 DPI 适配实战指南

前言：为什么我们非得折腾这个

说实话，如果你今年还在做GUI开发却没考虑过DPI问题，那你迟早要踩坑。笔者之前工作的时候，就出现了，换一个显示器，窗口不居中跑到边缘的问题。这事情真的不能怪显示器，纯粹是我们当年写代码的时候太"天真"了，默认世界上所有屏幕都是96 DPI。

事情的起因是这样的：显示器厂商这些年在像素密度上卷得厉害，以前的屏幕大概每英寸96个像素就算标准配置，现在动不动就200多甚至300 DPI。但我们的GUI代码还停留在旧时代，硬编码了一堆"看起来差不多"的尺寸值，结果在高分屏上要么小到看不见，要么被系统拉伸成一团模糊。

如果你跟我一样，需要维护一些"历史悠久"的桌面应用，或者打算从零开始写一个能在各种屏幕上都清晰显示的程序，那我们就得认真对待DPI这个问题了。这篇文章会带你完整走一遍 Windows 平台的 DPI 处理方案，把那些官方文档里分散在各种角落的知识点串起来，顺便分享一些笔者踩过的坑。

环境说明：我们在什么平台上折腾

在开始之前，先明确一下我们这篇文章涉及的技术栈和测试环境：

Windows平台：主要关注Win10 1703（Creators Update）及以上版本，因为这是Per-Monitor V2 DPI Awareness支持的起点
测试硬件：至少包含两个不同DPI的显示器（比如一个1080p的96 DPI，一个4K的192 DPI）
开发场景：既有从零开始的新项目，也有需要改造的老项目

第一步 —— 搞清楚DPI到底是个什么鬼

很多人一听到DPI就觉得是"图片清晰度"相关的东西，但在GUI编程的语境下，我们需要更准确地理解它。DPI（Dots Per Inch）指的是每英寸的像素点数，96 DPI意味着屏幕上每英寸有96个像素。这是一个物理密度概念。

但真正让我们头疼的是"显示缩放比例"（Display Scale Factor）。当你在Windows的显示设置里把缩放调成150%的时候，系统会告诉应用程序"现在的DPI是144"（96 × 1.5），然后应用程序需要据此调整自己的布局和渲染。

这里有个关键点需要理解：设备像素比（Device Pixel Ratio，简称DPR）。如果你的窗口设置为200×200"设备无关像素"，在DPI为96（DPR=1.0）的屏幕上它实际占用200×200个物理像素，但在DPI为192（DPR=2.0）的屏幕上它会占用400×400个物理像素。

这个模型的核心思想是：应用程序在一个"虚拟"的坐标系里工作，系统负责把虚拟坐标映射到真实的物理像素上。理想情况下，你只需要用"设备无关像素"来思考布局，剩下的事情让系统帮你处理。

当然，理想很丰满，现实往往很骨感 —— 尤其是当你需要处理一些底层绘图操作的时候。

第二步 —— Windows的DPI Awareness模式

Windows这块的设计历史包袱比较重，所以有好几种DPI Awareness模式，我们得一个个搞清楚。

DPI Unaware：最原始的模式

DPI Unaware的应用程序基本上就是在告诉Windows："我就按96 DPI来写，别的我不管"。当这种程序跑在高DPI屏幕上时，Windows会把整个窗口的位图拉伸到预期大小，结果就是你看到的模糊界面。

说实话，2025年了如果你还在写这种程序，那真的有点说不过去。但有些legacy代码确实是这样的，我们后面会讲怎么改造。

System DPI Awareness：稍微进步了一点

System DPI Aware的应用程序会在启动时获取主显示器的DPI，然后按照这个DPI来布局界面。听起来不错，但问题在于它只会在初始化时做一次这件事。当你把窗口拖到另一个DPI不同的显示器上时，Windows又会开始位图拉伸，于是你的界面又模糊了。

很多老程序都属于这一类，它们是"一个DPI用到死"的典型代表。

Per-Monitor和Per-Monitor V2：正确的方向

Per-Monitor DPI Awareness是Windows 8.1引入的，它的核心思想是：当DPI变化时，系统会发送WM_DPICHANGED消息给你的窗口，然后你需要自己重新布局。

但Per-Monitor V1的限制比较多，基本就是个"半成品"。Windows 10 Creators Update引入了Per-Monitor V2，这个才是真正可用的版本。当你的程序声明自己是PMv2 Aware时，你会得到这些好处：

窗口（包括子窗口）会在DPI变化时收到通知
你能看到每个显示器的真实像素数
Windows不会对你的窗口进行位图拉伸
非客户区（标题栏、滚动条等）会自动缩放
Win32对话框会自动处理DPI缩放
通用控件的位图资源会自动用正确的DPI渲染

当然，天下没有免费的午餐 —— 既然你告诉Windows"我自己来处理DPI"，那当DPI变化时，如果你没有重新布局，你的界面就会变得要么太小要么太大，完全取决于新旧DPI的差异。

下面这个表格总结了各种模式的行为差异：

DPI Awareness模式	Windows引入版本	应用程序看到的DPI	DPI变化时的行为
Unaware	-	所有显示器都是96 DPI	位图拉伸（模糊）
System	Vista	所有显示器都是主显示器的DPI	位图拉伸（模糊）
Per-Monitor	8.1	当前窗口所在显示器的DPI	顶级窗口收到通知，其他不管
Per-Monitor V2	Win10 1703	当前窗口所在显示器的DPI	顶级和子窗口都收到通知，非客户区、控件、对话框自动缩放

第三步 —— Win32实战：从System DPI Aware升级到Per-Monitor V2

假设我们有一个老的Win32程序，目前是System DPI Aware的（大部分老程序都是这样），我们想把它升级到Per-Monitor V2。这里有一系列步骤需要完成。

3.1 声明DPI Awareness模式

首先我们需要在application manifest里声明程序是Per-Monitor V2 DPI Aware。如果你的程序还没有manifest，那就需要创建一个；如果已经有了，就添加dpiAwareness相关的内容：

xml

<application xmlns="urn:schemas-microsoft-com:asm.v3">
  <windowsSettings>
    <dpiAware xmlns="http://schemas.microsoft.com/SMI/2005/WindowsSettings">true/PM</dpiAware>
    <dpiAwareness xmlns="http://schemas.microsoft.com/SMI/2016/WindowsSettings">PerMonitorV2</dpiAwareness>
  </windowsSettings>
</application>

这个声明告诉Windows："嘿，我知道怎么处理DPI变化，别帮我拉伸位图了"。

3.2 找出所有硬编码的尺寸

这步是最烦人的，但也是必须的。你需要在代码里搜索所有假设DPI固定为96的地方。常见的罪魁祸首包括：

直接写在代码里的像素值（比如CreateWindow时的x, y, width, height）
缓存的字体大小
缓存的DPI值
硬编码的图标尺寸

这里有个典型的错误示例：

cpp

case WM_CREATE:
{
    // 这段代码假设程序运行在96 DPI下
    HWND hWndChild = CreateWindow(L"BUTTON", L"Click Me",
        WS_CHILD|WS_VISIBLE|BS_PUSHBUTTON,
        50,   // x
        50,   // y
        100,  // width
        50,   // height
        hWnd, (HMENU)NULL, NULL, NULL);
}

按钮的位置和尺寸都是硬编码的，在高DPI屏幕上会显得很小。

正确的做法是先定义一些"96 DPI下的基准值"，然后在运行时根据实际DPI进行缩放：

cpp

#define INITIALX_96DPI 50
#define INITIALY_96DPI 50
#define INITIALWIDTH_96DPI 100
#define INITIALHEIGHT_96DPI 50

void UpdateButtonLayoutForDpi(HWND hWnd)
{
    int iDpi = GetDpiForWindow(hWnd);
    int dpiScaledX = MulDiv(INITIALX_96DPI, iDpi, USER_DEFAULT_SCREEN_DPI);
    int dpiScaledY = MulDiv(INITIALY_96DPI, iDpi, USER_DEFAULT_SCREEN_DPI);
    int dpiScaledWidth = MulDiv(INITIALWIDTH_96DPI, iDpi, USER_DEFAULT_SCREEN_DPI);
    int dpiScaledHeight = MulDiv(INITIALHEIGHT_96DPI, iDpi, USER_DEFAULT_SCREEN_DPI);
    SetWindowPos(hWnd, hWnd, dpiScaledX, dpiScaledY,
                 dpiScaledWidth, dpiScaledHeight, SWP_NOZORDER | SWP_NOACTIVATE);
}

MulDiv这个API很有用，它执行(a * b) / c的操作，并且会处理中间结果的溢出问题。这里我们用它来把96 DPI下的基准值按比例缩放到实际DPI。

然后在窗口创建时调用这个函数：

cpp

case WM_CREATE:
{
    HWND hWndChild = CreateWindow(L"BUTTON", L"Click Me",
        WS_CHILD|WS_VISIBLE|BS_PUSHBUTTON,
        0, 0, 0, 0,  // 尺寸由UpdateButtonLayoutForDpi设置
        hWnd, (HMENU)NULL, NULL, NULL);
    if (hWndChild != NULL)
    {
        UpdateButtonLayoutForDpi(hWndChild);
    }
}
break;

3.3 处理DPI变化消息

当我们声明为Per-Monitor DPI Aware后，当窗口被拖到不同DPI的显示器上时，会收到WM_DPICHANGED消息。我们需要处理这个消息，重新布局界面：

cpp

case WM_DPICHANGED:
{
    // 找到需要调整大小的控件并更新布局
    HWND hWndButton = FindWindowEx(hWnd, NULL, NULL, NULL);
    if (hWndButton != NULL)
    {
        UpdateButtonLayoutForDpi(hWndButton);
    }
}
break;

⚠️ 注意：这里有个重要的坑 —— WM_DPICHANGED消息的lParam参数包含一个建议的新窗口矩形。Windows强烈建议你用这个矩形来调整窗口大小，因为这样能确保：

鼠标指针在拖动窗口时保持在相对位置
避免触发递归的DPI变化循环

更完整的处理应该是这样的：

cpp

case WM_DPICHANGED:
{
    // 获取建议的窗口矩形
    LPRECT lpRect = (LPRECT)lParam;

    // 调整窗口大小
    SetWindowPos(hWnd, NULL,
                 lpRect->left, lpRect->top,
                 lpRect->right - lpRect->left,
                 lpRect->bottom - lpRect->top,
                 SWP_NOZORDER | SWP_NOACTIVATE);

    // 更新子窗口布局
    UpdateAllChildLayouts(hWnd);
}
break;

3.4 替换不支持DPI上下文的API

很多老版本的Win32 API没有DPI或HWND上下文参数，它们返回的值可能是"虚拟化"的（即被系统按照某种DPI Awareness模式转换过）。Windows提供了带ForDpi后缀的新版API：

老API	新API
GetSystemMetrics	GetSystemMetricsForDpi
AdjustWindowRectEx	AdjustWindowRectExForDpi
SystemParametersInfo	SystemParametersInfoForDpi
GetDpiForMonitor	GetDpiForWindow

你需要在代码里搜索这些老API的调用，并根据具体情况替换。如果老API是在某个HWND相关的上下文中调用的，通常可以改用GetDpiForWindow获取DPI后再调用新API。

3.5 处理位图资源

当DPI变化时，你需要重新加载位图资源。如果你只提供了单分辨率的图片，可能需要手动缩放。更好的做法是提供多分辨率的资源，然后根据当前DPI选择合适的版本。

对于图标，可以使用LoadImage代替LoadIcon，因为它支持指定尺寸：

cpp

HICON hIcon = (HICON)LoadImage(
    hInstance,
    MAKEINTRESOURCE(IDI_MYICON),
    IMAGE_ICON,
    GetSystemMetricsForDpi(SM_CXICON, GetDpiForWindow(hWnd)),
    GetSystemMetricsForDpi(SM_CYICON, GetDpiForWindow(hWnd)),
    LR_DEFAULTCOLOR
);

3.6 测试清单

改造完成后，你需要测试以下场景：

在不同DPI的显示器上启动程序
把窗口在不同DPI的显示器之间拖动
程序运行时更改显示器的缩放设置
更改主显示器，注销后重新登录测试
远程桌面连接到不同DPI的机器

如果所有场景下界面都能保持清晰且尺寸合理，恭喜你，你的程序已经正确支持DPI缩放了。

第四步 —— 踩坑预警与进阶话题

这里整理一些笔者在折腾过程中遇到的坑点和进阶问题。

DPI虚拟化的陷阱

当一个DPI Unaware或System DPI Aware的窗口被Windows拉伸时，某些API的返回值会被"虚拟化" —— 即返回的是转换后的值，而不是真实值。这可能导致混淆。

比如，一个DPI Unaware的线程在4K屏幕上查询屏幕尺寸时，Windows会返回一个"虚拟"的尺寸（好像屏幕只有96 DPI一样）。这本身没问题，但如果你混用不同DPI Awareness的代码，可能会踩坑。

解决办法：确保调用API时的线程DPI上下文是你期望的。如果需要临时改变上下文，使用SetThreadDpiAwarenessContext，记得恢复：

cpp

DPI_AWARENESS_CONTEXT oldContext = SetThreadDpiAwarenessContext(DPI_AWARENESS_CONTEXT_PER_MONITOR_AWARE_V2);
// ... 调用需要特定上下文的API ...
SetThreadDpiAwarenessContext(oldContext);

混合模式DPI缩放

当你没法一次性更新所有窗口时，可以让部分窗口保持旧的DPI模式，只更新重要的窗口。从Windows 10 1607开始，DPI Awareness可以按顶级窗口设置：

cpp

// 创建一个使用System DPI的窗口
SetThreadDpiAwarenessContext(DPI_AWARENESS_CONTEXT_SYSTEM_AWARE);
HWND hSecondaryWindow = CreateWindow(...);
SetThreadDpiAwarenessContext(DPI_AWARENESS_CONTEXT_PER_MONITOR_AWARE_V2);

// 主窗口使用Per-Monitor V2
HWND hMainWindow = CreateWindow(...);

这个功能要慎用，因为它会增加程序复杂度。只应该在过渡期使用，最终目标还是让所有窗口都正确处理DPI。

非整数缩放的问题

Windows允许以125%、150%这样的比例缩放，这会产生非整数的DPR（1.25、1.5）。Win32 程序在这种情况下可能出现子控件对齐不精确的问题。

处理方法：在布局计算中始终使用浮点或 MulDiv 进行精确的 DPI 换算，避免将缩放结果截断为整数后再用于布局。

测试工具推荐

Windows内置工具

Windows的设置页面可以方便地调整缩放比例来测试：

打开"设置 > 系统 > 显示"
修改"缩放与布局"
观察程序是否正确响应

远程桌面测试

如果你想在没有多显示器的环境下测试 DPI 切换行为，可以通过远程桌面连接到一台不同 DPI 配置的机器，观察程序是否正确处理。

收尾

到这里我们就把 Windows 平台的 DPI 处理完整梳理完了。说实话，DPI这个话题确实有点枯燥，但它对于现代GUI应用来说是绕不过去的一道坎。

如果你正在维护一个老项目，希望这篇文章能给你一个清晰的升级路线。如果你是从零开始的新项目，记得在项目早期就把 DPI 适配纳入计划，声明 Per-Monitor V2 并使用带 ForDpi 后缀的 API。

最后提醒一点：DPI支持最好在项目早期就考虑好，越到后面改造成本越高。不要像笔者这样，等在4K屏幕上看到模糊界面时才想起来要处理这个事情。

完结撒花，你的GUI应用终于可以在各种屏幕上都清晰显示了！

编程GUI到底什么是DPI —— Windows 平台 DPI 适配实战指南 ​

前言：为什么我们非得折腾这个 ​

环境说明：我们在什么平台上折腾 ​

第一步 —— 搞清楚DPI到底是个什么鬼 ​

第二步 —— Windows的DPI Awareness模式 ​

DPI Unaware：最原始的模式 ​

System DPI Awareness：稍微进步了一点 ​

Per-Monitor和Per-Monitor V2：正确的方向 ​

第三步 —— Win32实战：从System DPI Aware升级到Per-Monitor V2 ​

3.1 声明DPI Awareness模式 ​

3.2 找出所有硬编码的尺寸 ​

3.3 处理DPI变化消息 ​

3.4 替换不支持DPI上下文的API ​

3.5 处理位图资源 ​

3.6 测试清单 ​

第四步 —— 踩坑预警与进阶话题 ​

DPI虚拟化的陷阱 ​

混合模式DPI缩放 ​

非整数缩放的问题 ​

测试工具推荐 ​

Windows内置工具 ​

远程桌面测试 ​

收尾 ​