Windows 上用 GetSystemMetrics 获取主屏分辨率最稳，因其轻量、兼容性好且无需初始化窗口；它返回逻辑像素，SM_CXSCREEN 和 SM_CYSCREEN 直接获取主显示器宽高（不含任务栏）。
Windows 上用 GetSystemMetrics 获取主屏分辨率最稳
Windows GDI 的 GetSystemMetrics 是最轻量、兼容性最好的方式，不需要初始化窗口或依赖高版本 SDK。它返回的是逻辑像素（DPI 感知前），对多数后台工具或配置读取场景足够用。
常见错误是误用 GetDeviceCaps 或 EnumDisplayMonitors：前者需 HDC 句柄易出错，后者要遍历且默认只返回主屏信息不明确；而 GetSystemMetrics(SM_CXSCREEN) 和 SM_CYSCREEN 直接、无副作用。
-
SM_CXSCREEN返回主显示器水平像素数（不含任务栏） - 若需多屏总尺寸，必须用
EnumDisplayMonitors+GetMonitorInfo，但注意rcMonitor是虚拟屏幕坐标系，可能含负值 - 启用 DPI 感知后，
GetSystemMetrics仍返回物理像素——这点常被忽略，导致高分屏上 UI 计算偏小
X11 下靠 XDefaultRootWindow + XScreenNumberOfScreen 避免硬编码
X11 没有“系统级”分辨率 API，必须通过 Display* 连接获取默认屏幕信息。直接调 XScreenCount 然后取第 0 屏是常见误区：它返回的是 X server 启动时的屏幕数，不是当前活跃显示器数量。
真正可靠的做法是先用 XDefaultRootWindow 拿到根窗口，再用 XScreenNumberOfScreen 关联到对应 Screen*，最后读 WidthOfScreen 和 HeightOfScreen。
立即学习“C++免费学习笔记（深入）”；
- 必须检查
XOpenDisplay(nullptr)返回值，空指针在 headless 环境（如 CI）下极常见 -
WidthOfScreen返回的是当前 Screen 的物理像素，但 X11 多屏拼接后该值可能远大于单个显示器——需要额外调XineramaQueryScreens或XRandR才能拆解 - 不要依赖
DisplayWidth/DisplayHeight：它们参数是Display*和screen_number，但 screen_number 在现代多 GPU 场景下语义模糊
Cocoa 中 [NSScreen mainScreen] 默认返回主屏，但需手动处理缩放
Cocoa 的 [NSScreen mainScreen] 看似简单，但它返回的是“主显示器”（用户设置中勾选了“将菜单栏放在此显示器上”的那个），不是分辨率最高的屏，也不是当前窗口所在屏。
更关键的是，[NSScreen frame] 返回的是点（points），不是像素——macOS 的 backingScaleFactor 决定了实际像素密度。漏掉这步会导致 Retina 屏上拿到的分辨率只有真实值的一半。
- 正确写法：
NSRect frame = [[NSScreen mainScreen] frame]; CGFloat scale = [[NSScreen mainScreen] backingScaleFactor]; int w = (int)(frame.size.width * scale); int h = (int)(frame.size.height * scale); - 若需所有屏幕列表，用
[NSScreen screens]，但注意它包含隐藏屏（如 AirPlay 投射目标），需过滤isHidden和isDrawingSuppressed - 沙盒环境下，某些屏幕属性（如
deviceDescription）可能为空，不能用来推断分辨率
跨平台封装时别碰 glfwGetVideoMode 或 SDL_GetDesktopDisplayMode
第三方库看似省事，但它们的行为差异大：GLFW 的 glfwGetVideoMode 实际读的是当前上下文关联的显示器模式，没创建窗口就调用会返回空；SDL 的 SDL_GetDesktopDisplayMode 在 Wayland 下可能 fallback 到 640×480，且 Windows 上它返回的是“推荐”分辨率而非当前设置。
真要封装，建议按平台条件编译，每层只做一件事：Windows 走 GDI，X11 走原生 Xlib（别引入 Xrandr 依赖），Cocoa 走 AppKit。中间加一层 C 接口，避免 Objective-C++ 污染核心逻辑。
- 别试图用
GetSystemMetrics+XScreenCount+[NSScreen mainScreen]在同一函数里混写——预处理器分支容易漏改，编译时也难覆盖全部路径 - Linux 上 Wayland 已成主流，但
XDefaultRootWindow在纯 Wayland 会失败，此时应检测WAYLAND_DISPLAY环境变量并跳过 X11 分支 - 所有平台都得处理“无图形环境”场景（SSH 登录、systemd service），直接返回默认值（如 1920×1080）比崩溃更合理
跨平台分辨率获取真正的麻烦不在 API 调用本身，而在每个平台对“主屏”“当前屏”“逻辑尺寸”“物理尺寸”的定义根本不一致。把“主屏分辨率”当做一个确定值来用，本身就是个危险假设。
