**使用 Python 获取屏幕尺寸的主流做法分三类：跨平台库（如 tkinter、PyAutoGUI、screeninfo）、原生系统 API（Windows GetSystemMetrics、macOS Quartz、Linux xrandr）与 GUI 框架接口（Qt 的 QScreen、wxPython、Pygame）。实际落地时需区分分辨率（像素宽高）与 DPI/缩放比导致的“逻辑像素”，并考虑多显示器与旋转。**在常见桌面脚本里，PyAutoGUI.size() 足够；统计多屏信息用 screeninfo；构建 GUI 程序建议用 QScreen，同步开启 Windows DPI 感知，以避免缩放带来的坐标错位。

## 一、核心结论与快速方案
在不同操作系统与窗口系统上，屏幕尺寸信息存在“逻辑像素”和“物理像素”之分，缩放（DPI scaling）会导致应用读到的宽高并非真实像素。**若你想快速得到“当前主屏分辨率”：PyAutoGUI.size() 或 tkinter.winfo_screenwidth()/winfo_screenheight() 即可；若要“多显示器全部分辨率与坐标”：screeninfo.get_monitors() 更稳妥；若要“精确到真实像素并处理 DPI”：Windows 下开启 DPI 感知后用 GetSystemMetricsForDpi，Qt 程序用 QScreen.pixelDensity 与 geometry。**在自动化与截图场景，多屏坐标合成也要考虑。

对于脚本自动化与批量截图，**PyAutoGUI 在 Windows、macOS、Linux 上都能快速返回分辨率**，但它默认得到的是逻辑坐标，若系统缩放为 125% 或 150%，需要配合系统 API 或框架获取 DPI 才能换算物理像素。若你运行在容器或远程桌面，屏幕信息可能为空或返回虚拟值，建议回退到环境变量、虚拟 X 服务器（如 Xvfb）或使用 screeninfo 遍历可见输出，这样能提升跨环境稳定性并减少脚本出错率。

当你需要构建桌面 GUI 或需要对齐像素级 UI，**Qt（PyQt/PySide）提供的 QScreen 接口较为全面**，可获取每块屏幕的 geometry、availableGeometry、logicalDotsPerInch、devicePixelRatio 等，适合对齐高分屏、混合 DPI 的复杂桌面。对于 Windows 原生工具，ctypes 调用 Win32 API 可直连系统真实指标；macOS 用 Quartz 或 AppKit 的 NSScreen；Linux 在 X11 下可读取 xrandr 输出。选择何种方式，应以“跨平台一致性、DPI 准确性、依赖复杂度”三项指标综合权衡。

## 二、跨平台方法详解（tkinter、PyAutoGUI、screeninfo）
### tkinter：轻量获取分辨率的标准库方案
tkinter 是 Python 标准库的一部分，**无需额外安装即可通过 root.winfo_screenwidth()/winfo_screenheight() 获取主屏逻辑宽高**。这非常适合快速脚本与教学场景，但它默认返回的是逻辑像素，在高 DPI 模式下与实际像素存在差异。你也可以使用 winfo_fpixels("1i") 等接口推导 DPI，但跨平台一致性仍不如专业框架。根据 Python 官方文档对 tkinter 接口的说明（Python Docs, 2024），这些方法在大多数桌面环境稳定可用，前提是已初始化 Tk 上下文。

示例（仅主屏分辨率，逻辑像素）：
```python
import tkinter as tk

root = tk.Tk()
root.withdraw()  # 不显示窗口
width = root.winfo_screenwidth()
height = root.winfo_screenheight()
print(width, height)
root.destroy()
```
在多屏与缩放混合时，**tkinter 的简洁性意味着能力边界**：它不能直接枚举多显示器，也不提供每屏 DPI。若你仅需要“能用”的分辨率数字，它高效可靠；若你关心像素级精度、坐标系和混合缩放，请考虑 screeninfo 或 GUI 框架接口，以获得每块屏幕的几何与缩放信息以实现严谨布局。

### PyAutoGUI：自动化脚本中的分辨率便捷入口
PyAutoGUI 的 size() 返回屏幕宽高，position()/moveTo() 等配合鼠标键盘自动化广受使用。**它的优势是安装简单、用法统一、在三大桌面平台上返回一致的“逻辑分辨率值”**，非常适合自动化、截屏、UI 测试等脚本。但若系统缩放开启，像素与坐标会映射到逻辑空间，截图与图像匹配需要用相同坐标系，以避免偏移与模糊。

示例（快速获取主屏逻辑宽高）：
```python
import pyautogui
w, h = pyautogui.size()
print(w, h)
```
在混合 DPI 的多屏下，**PyAutoGUI 提供的单值并不足以覆盖全部显示器**。你可以配合 screeninfo 获取每块屏的边界，再根据鼠标所在屏做坐标换算；或在 Windows 下同时启用 DPI 感知，确保坐标解析和截图一致。若你的场景强调跨平台自动化与“足够准确”，PyAutoGUI 是高性价比选择，但要对 DPI 引发的逻辑像素差异保有警惕并设计回退策略。

### screeninfo：多显示器与旋转信息更完善
screeninfo 库可枚举每块显示器，**返回 x、y、width、height、is_primary 等信息，便于处理多屏与坐标合并**。与只给主屏宽高的方案相比，它能帮助你构建完整的“虚拟桌面矩形”，从而处理跨屏截图、窗口放置和边界检测。对于需要了解屏幕旋转（如竖屏）与相对位移的场景，它比 tkinter 和 PyAutoGUI 更贴近工程需求。

示例（列出所有显示器逻辑几何）：
```python
from screeninfo import get_monitors
for m in get_monitors():
    print(m.name, m.x, m.y, m.width, m.height, getattr(m, "is_primary", False))
```
需要注意的是，**screeninfo 在不同平台上底层实现有所差异**，在 Wayland 或远程桌面下可能出现受限信息或未列出全部显示器的情况。为增强鲁棒性，你可以在 Linux/X11 结合 xrandr 结果校验，在 Windows 同时查询 DPI 或使用 Qt 的 QScreen 交叉验证。这样做虽增加少许复杂度，但能显著提高跨机房、跨操作系统的稳定性与一致性。

## 三、操作系统原生 API 与 DPI 注意事项（Windows/macOS/Linux）
### Windows：GetSystemMetrics 与 DPI 感知的关键性
在 Windows 上，GetSystemMetrics 可获取屏幕尺寸，**但若进程未开启“高 DPI 感知”，得到的往往是缩放后的逻辑值**。Windows 10+ 提供 SetProcessDpiAwarenessContext 或 SetProcessDpiAwareness/SetProcessDPIAware 来切换感知级别，之后可用 GetSystemMetricsForDpi 针对特定 DPI 查询（Microsoft Learn, 2024）。这对需要像素级对齐的绘制、截图与坐标计算尤其关键。

示例（启用 DPI 感知并获取真实像素的分辨率）：
```python
import ctypes
user32 = ctypes.windll.user32
shcore = ctypes.windll.shcore

# 尝试开启 DPI 感知（Windows 8.1+）
try:
    shcore.SetProcessDpiAwareness(2)  # PROCESS_PER_MONITOR_DPI_AWARE
except Exception:
    user32.SetProcessDPIAware()  # 兼容旧系统

# 获取主屏分辨率（物理像素）
w = user32.GetSystemMetrics(0)  # SM_CXSCREEN
h = user32.GetSystemMetrics(1)  # SM_CYSCREEN
print(w, h)
```
对于多显示器环境，**每块屏的 DPI 可能不同**，这会导致坐标映射与截图清晰度差异。你可以使用 MonitorFromPoint/EnumDisplayMonitors 枚举显示器，配合 GetDpiForMonitor 逐个查询 DPI，再做坐标换算。虽然实现更复杂，但能确保在混合 DPI 下的绘制与自动化一致性。

### macOS：Quartz/AppKit 与点像素的换算
macOS 使用点（points）与像素（pixels）概念，**Retina 屏下 1 point 对应 2 像素或更多**。通过 Quartz 或 AppKit 的 NSScreen 能获得 frame（以点计）与 backingScaleFactor（缩放倍数）。因此屏幕像素尺寸 = 点尺寸 × 缩放倍数。如果你只取到点数，截图或图像匹配会模糊或位置偏移。Apple 的开发者文档对坐标与缩放比有系统说明（Apple Developer, 2024）。

示例（AppKit 读取主屏点尺寸与缩放比，换算像素）：
```python
from AppKit import NSScreen
screen = NSScreen.mainScreen()
frame = screen.frame()
scale = screen.backingScaleFactor()
pixel_w = int(frame.size.width * scale)
pixel_h = int(frame.size.height * scale)
print(pixel_w, pixel_h)
```
在多显示器下，**不同屏的 backingScaleFactor 可以不同**，你应遍历 NSScreen.screens()，为每块屏分别计算像素几何与可用区域。此外，若你的 Python 仅在命令行运行，需确保已加载合适的 Cocoa 环境；GUI 应用（如 PyQt）通常可直接通过框架抽象层拿到一致的像素与可用工作区数据，避免重复造轮子。

### Linux（X11/Wayland）：xrandr 与环境差异
在 Linux 上，图形栈存在 X11 与 Wayland 差异。**X11 下 xrandr 能稳定返回连接的显示器、分辨率与相对位置**；Wayland 默认更注重安全隔离，对全局屏幕信息与全局截图的访问受限。若你的脚本依赖完整屏幕几何，优先在 X11 会更可控；在 Wayland 下需要使用桌面环境提供的 API 或权限扩展，或通过 GUI 框架抽象来规避差异。

示例（解析 xrandr 输出）：
```python
import subprocess, re
out = subprocess.check_output(["xrandr", "--current"]).decode()
current = re.findall(r" connected.*?(\d+)x(\d+)\+(\d+)\+(\d+)", out)
print(current)  # [(width, height, x, y), ...]
```
需要注意，**容器或无头环境可能没有可用的 DISPLAY**，这会导致 xrandr 调用失败。可通过 Xvfb 启动虚拟显示，或在 CI 中分支判断为“无图形环境”模式，回退到默认配置值。对于追求跨平台一致性的项目，使用 Qt 的 QScreen 或 screeninfo 抽象层可降低 X11/Wayland 差异对业务的干扰。

## 四、GUI 框架方案对比与示例（PyQt/PySide、wxPython、Pygame）
Qt 在桌面生态中成熟度高，**QScreen 提供 geometry、availableGeometry、logicalDotsPerInch、devicePixelRatio 等丰富指标**，适合处理高分屏与多显示器。wxPython 也能获取显示器信息与 PPI，但在混合 DPI 的一致性上需要更多测试；Pygame 偏向游戏渲染，display.Info() 能给出当前显示模式与显卡能力，适合全屏与渲染内的坐标管理。根据 Qt 官方文档（Qt Documentation, 2024），QScreen 是跨平台读取屏幕数据的核心入口，且对高 DPI 有系统支持。

示例（Qt：列出全部屏幕几何与缩放）：
```python
from PySide6.QtGui import QGuiApplication
import sys
app = QGuiApplication(sys.argv)
for s in app.screens():
    g = s.geometry()
    print(s.name(), g.x(), g.y(), g.width(), g.height(),
          s.devicePixelRatio(), s.logicalDotsPerInch())
```
在选择框架时，**建议以“是否已用该框架构建 UI”为优先级**：若你的程序本就基于 Qt，直接用 QScreen；若仅是脚本，screeninfo 或 PyAutoGUI 够用；若构建游戏或多媒体演示，Pygame 的 display.Info() 在统一坐标系方面更贴切。这样能在保持依赖简洁的同时，确保屏幕尺寸与缩放信息的精度与一致性。

对比表（跨平台 Python 获取屏幕尺寸常见方案）：
| 方案 | 跨平台支持 | 获取分辨率 | DPI处理 | 多显示器 | 依赖体量 | 复杂度 | 典型场景 |
|---|---|---|---|---|---|---|---|
| tkinter | 强 | 主屏逻辑分辨率 | 弱 | 无 | 极小（内置） | 低 | 教学、脚本 |
| PyAutoGUI | 强 | 主屏逻辑分辨率 | 一般 | 无 | 小 | 低 | 自动化、截图 |
| screeninfo | 中-强 | 全部屏逻辑几何 | 一般 | 有 | 小 | 中 | 多屏统计、布局 |
| PyQt/PySide(QScreen) | 强 | 全部屏像素/区域 | 强 | 有 | 中-大 | 中 | 桌面 GUI、高分屏 |
| wxPython | 强 | 主/多屏信息 | 中 | 有 | 中 | 中 | 跨平台 GUI |
| Pygame | 中 | 当前显示模式 | 弱 | 有限 | 中 | 中 | 渲染/全屏 |
| Win32 API | 弱（仅 Win） | 像素分辨率 | 强 | 有 | 小 | 高 | 系统工具 |
| xrandr | 弱（X11） | 像素分辨率 | 一般 | 有 | 小 | 中 | Linux 工具化 |

## 五、复杂环境与自动化场景（容器、远程桌面、CI）
在容器与无头（headless）环境中，**没有实际物理显示器，很多库会返回空或默认值**。常见做法是在 CI/Docker 中启动 Xvfb，提供虚拟显示以让 GUI 测试与截图通过，同时在代码中设置健壮的回退：如未检测到 DISPLAY 或 screeninfo 返回空，则采用配置文件中的默认分辨率并提示降级模式。这样能保证流水线稳定运行，避免因环境差异导致的脆弱性。

远程桌面（RDP/VNC）会动态改变分辨率与缩放，**会话重连后屏幕尺寸可能瞬间变化**，因此推荐在关键操作前“再次读取屏幕信息”，并在脚本中做幂等控制。例如对截图比对、元素寻址先刷新坐标缓存，再执行点击或渲染。对于安全策略较严格的 Wayland 会话，考虑改用框架内渲染坐标而非全局屏幕抓取，以提高权限兼容性并减少失败率。

当你的团队需要在多机型、多操作系统与多屏组合下做自动化验证，**应建立“环境矩阵”与“能力探针”**：启动时探测 OS、会话类型、DPI、缩放、屏幕几何，记录到日志/数据库，供后续定位问题与回归测试复用。在协作层面，你可以借助项目协作与研发流程工具管理环境清单与脚本变更，例如将“分辨率/DPI策略”纳入需求与测试用例，这类流程可在 [PingCode](https://PingCode.com?utm_source=insights&utm_medium=%E5%93%81%E7%89%8C%E8%AF%8D) 等研发项目管理系统中以模板化方式沉淀，便于多端协作与可追溯。

## 六、多显示器与坐标系实战要点
在多显示器场景，桌面形成一个“组合矩形空间”，**每块屏有自己的原点与宽高，并通过 x、y 偏移拼接**。例如左侧竖屏可能有负 x 坐标，主屏从 (0,0) 开始，右侧副屏在正向偏移。布局窗口、全屏截图或跨屏拖拽时，必须先合并所有监视器的边界，计算全局最小 x、最小 y、最大右边界与最大下边界，以得到虚拟桌面的总宽高，避免跨屏时越界或被系统吸附改变位置。

示例（基于 screeninfo 计算虚拟桌面边界与坐标换算）：
```python
from screeninfo import get_monitors

mons = list(get_monitors())
min_x = min(m.x for m in mons)
min_y = min(m.y for m in mons)
max_r = max(m.x + m.width for m in mons)
max_b = max(m.y + m.height for m in mons)
virtual_w, virtual_h = max_r - min_x, max_b - min_y
print("virtual:", virtual_w, virtual_h)

def to_global(x, y, monitor):
    return x + monitor.x, y + monitor.y
```
在混合 DPI 的多屏环境，**全局坐标与每屏逻辑像素可能不一致**。若你使用 Qt，可对每个 QScreen 读取 devicePixelRatio 与 DPI，先在屏幕本地逻辑坐标内完成布局，再映射到物理像素做截图或图像处理。若用跨平台脚本（如 PyAutoGUI+screeninfo），建议统一在“逻辑坐标体系”内操作，截图和图片匹配均用同一坐标基准，以减小缩放差异带来的误差。

## 七、总结与未来趋势
综合来看，获取屏幕尺寸并不只是拿到两个整数，**关键在于正确理解“逻辑像素 vs 物理像素”、DPI/缩放比、多显示器坐标与会话环境（本地/远程/容器）**。脚本层面，tkinter 与 PyAutoGUI 高效易用；多屏统计用 screeninfo；GUI 产品建议依赖 QScreen 等框架层能力；在 Windows/macOS/Linux 上原生 API 可提供最精确但实现成本更高。工程实践中，建立“探测-回退-记录”的稳健流程尤为重要。

未来，桌面生态将继续强化高 DPI 与混合缩放的体验，**Wayland 等更安全的显示协议将限制全局屏幕与截图能力**，这会推动更多应用转向框架内部 API 与用户授权的能力边界。跨平台抽象层将变得更重要，结合环境探针与配置化策略能提高健壮性。在协作层面，团队可将“屏幕尺寸与坐标策略”纳入需求、测试与变更管理流程，利用如 [PingCode](https://PingCode.com?utm_source=insights&utm_medium=%E5%93%81%E7%89%8C%E8%AF%8D) 这类研发项目全流程管理系统沉淀规范与指标，持续提升多端一致性与交付质量。

参考与资料来源：
- Python Software Foundation. “tkinter — Python interface to Tcl/Tk.” https://docs.python.org/3/library/tkinter.html （Python Docs, 2024）
- Microsoft Learn. “GetSystemMetrics function (winuser.h).” https://learn.microsoft.com/windows/win32/api/winuser/nf-winuser-getsystemmetrics （Microsoft Learn, 2024）
- Qt Documentation. “QScreen Class.” https://doc.qt.io/qt-6/qscreen.html （Qt Documentation, 2024）
- Apple Developer Documentation. “Coordinate Systems and Drawing.” https://developer.apple.com/documentation/appkit （Apple Developer, 2024）

可以使用Python的第三方库如tkinter或pygetwindow来获取屏幕分辨率。例如，使用tkinter库，通过创建一个Tk()实例并调用其.winfo_screenwidth()和.winfo_screenheight()方法即可获得屏幕的宽度和高度。

使用Python获取屏幕分辨率的方法

我想通过Python程序获取电脑屏幕的分辨率，应该使用哪些方法或库？

如何在Python中获取当前屏幕的宽度和高度？

tkinter是一个跨平台的标准Python库，支持在Windows、macOS和Linux上工作。除此之外，库如pyautogui也能方便地获取显示器尺寸，非常适合需要跨系统适配的场景。

跨平台获取屏幕尺寸的Python库推荐

我需要确保Python脚本在Windows、macOS和Linux都能正确获取屏幕大小，有哪些推荐的库？

是否有跨平台的Python库能够获取屏幕尺寸？

可以使用专门的库如screeninfo，它支持检测多个显示器的尺寸和坐标信息。通过调用screeninfo.get_monitors()函数，可以获得所有连接显示器的详细数据，方便多屏幕应用的开发。

处理多显示器屏幕尺寸的Python方案

如果用户连接了多个显示器，我要怎么通过Python来获取每个屏幕的分辨率和位置信息？

如何用Python检测多显示器环境下的各个屏幕尺寸？

PingCodeDocs

本文系统梳理了Python获取屏幕尺寸的可行路径，给出跨平台快速实践与高精度方案：脚本用PyAutoGUI或tkinter获取主屏逻辑分辨率，多显示器与旋转用screeninfo遍历，像素级精度与混合DPI则在Windows启用DPI感知并调用系统API，或在GUI程序中使用Qt的QScreen读取像素与缩放指标。针对容器、远程桌面与Wayland等复杂环境，文中提出“探测-回退-记录”的稳健流程，并给出多屏坐标合成、截图一致性与缩放换算的实战要点。整体策略是依据目标场景在“易用性、跨平台一致性、DPI精度”之间权衡，并将屏幕策略纳入团队协作与测试基线以提升交付的稳定性与可维护性。

Python如何获得屏幕的尺寸