如何获取屏幕上的像素坐标

实时演示：坐标拾取器

上方那个方框是可交互的。把鼠标移上去，你会看到四个数值实时变化：X 和 Y 是从整个屏幕左上角算起的坐标，而相对 X 和 Y 是从演示框自身左上角算起的坐标。

这个区分 -- 屏幕坐标与元素相对坐标 -- 是刚接触像素坐标的人最容易搞混的地方。屏幕坐标告诉你某个点在显示器上的位置，相对坐标告诉你它在某个窗口或元素内部的位置。大部分 API 只给其中一个，少数两个都给，但数值几乎不会相等。

Windows：PowerShell、截图工具等

Windows 没有自带显示坐标的功能。没有任何内置应用能跟着光标走并打印 X/Y 数值。你有三个真正可行的选择，选哪个取决于你是要快速看一眼还是要可编程的方案。

方法一：PowerShell + Win32 API（可直接复制）

这是我最常用的方法。它调用的是每个 Windows 程序内部都在用的 GetCursorPos 函数，所以返回的是物理屏幕像素坐标 -- 不受显示缩放影响。把下面的代码粘到 PowerShell 窗口里：

Add-Type @"
using System;
using System.Runtime.InteropServices;
public class User32 {
    [StructLayout(LayoutKind.Sequential)]
    public struct POINT { public int X; public int Y; }
    [DllImport("user32.dll")]
    public static extern bool GetCursorPos(out POINT lpPoint);
}
"@
while ($true) {
    $p = New-Object User32+POINT
    [User32]::GetCursorPos([ref]$p)
    Write-Host "`rX: $($p.X)  Y: $($p.Y)" -NoNewline
    Start-Sleep -Milliseconds 100
}

移动鼠标就能看到数值变化，按 Ctrl+C 停止。每秒更新 10 次，对大部分场景够用，也不会占满 CPU。

方法二：截图工具（快速读数）

截图工具本身不直接显示坐标，但它有个有用的副作用：当你开始截图时，十字准星附近会显示当前像素位置的小提示。精度不够做自动化，但如果只是想大概看一下位置，足够了。

快捷打开：按 Win + Shift + S，屏幕变暗出现十字准星。移动准星，留意附近的像素读数。按 Esc 取消截图。

方法三：Python + PyAutoGUI

如果你已经在用 Python 写自动化，pyautogui 就是标准库。用 pip install pyautogui 安装，然后：

import pyautogui, time
while True:
    x, y = pyautogui.position()
    print(f"\rX: {x}  Y: {y}", end="", flush=True)
    time.sleep(0.1)

想深入了解 PyAutoGUI -- 包括 click()、moveTo() 和多显示器处理 -- 请看 PyAutoGUI 屏幕坐标指南。

macOS：数码测色计与终端

macOS 在这方面的工具比 Windows 好得多。你有一个自带工具可以实时显示坐标，终端方案也相当能干。

自带工具：数码测色计（Digital Color Meter）

打开 Spotlight（Cmd + Space），输入"Digital Color Meter"。这个应用在 应用程序 / 实用工具 里，本来是读取像素颜色的，但它也会在窗口底部实时显示光标的屏幕坐标。这是 Mac 上不用写代码就能获取坐标的最快方法。

终端：Python + Quartz（精确且可编程）

做自动化时，Quartz 框架给的是和操作系统内部一模一样的坐标数据。麻烦的地方在于：macOS 的 Y 轴是从屏幕底部算的，不是从顶部。大部分其他系统用左上角做原点。如果你要把 Windows 上的脚本移植过来，需要翻转 Y 值。

import Quartz, time
while True:
    loc = Quartz.CGEventGetLocation(
        Quartz.CGEventCreate(None))
    h = Quartz.CGDisplayPixelsHigh(
        Quartz.CGMainDisplayID())
    # macOS 的 Y 从底部算，翻转为左上角原点
    print(f"\rX: {int(loc.x)}  Y: {int(h - loc.y)}",
          end="", flush=True)
    time.sleep(0.1)

先安装 Quartz：pip install pyobjc-framework-Quartz。翻转后的 Y 坐标就和浏览器或 Windows 坐标系统一致了。

Linux：xdotool 与 xwininfo

Linux 有最好的命令行坐标工具，部分原因是 X11 从设计之初就支持脚本化。Wayland 正在追赶，但部分工具在纯 Wayland 会话下可能不可用 -- 见下方说明。

xdotool：一次性读取坐标

安装：sudo apt install xdotool（Debian/Ubuntu）或你所用发行版的包管理器。然后：

# 打印当前鼠标位置
xdotool getmouselocation --shell
# 输出格式：
# X=1920
# Y=540
# SCREEN=0
# WINDOW=16777216

--shell 参数把输出格式化为 shell 变量，可以直接在 bash 脚本里 source：

eval "$(xdotool getmouselocation --shell)"
echo "鼠标位置 $X, $Y，屏幕 $SCREEN"

实时跟踪循环

while true; do
    eval "$(xdotool getmouselocation --shell)"
    printf "\rX: %-5s  Y: %-5s" "$X" "$Y"
    sleep 0.1
done

xwininfo：窗口级坐标

如果你需要的是相对于某个窗口的坐标而不是屏幕坐标，xwininfo 就派上用场了。在终端运行 xwininfo，然后点击你想检查的窗口。它会打印窗口的绝对位置、尺寸和角点坐标。

浏览器：开发者工具与 JavaScript

如果你要找的是网页内部的坐标 -- 点击、拖拽测试或布局调试 -- 不需要任何系统级工具。浏览器通过 JavaScript 给你一切，开发者工具可以交互式查看坐标。

开发者工具控制台代码

打开开发者工具（F12 或 Cmd+Option+I），切到 Console 标签，粘贴：

document.addEventListener('mousemove', e => {
  console.clear();
  console.log('Screen:  ' + e.screenX + ', ' + e.screenY);
  console.log('Client:   ' + e.clientX + ', ' + e.clientY);
  console.log('Page:     ' + e.pageX + ', ' + e.pageY);
  console.log('Offset:   ' + e.offsetX + ', ' + e.offsetY);
});

现在在页面上移动鼠标，看控制台更新。每对值的原点不同，理解这个差异对 Web 开发至关重要：

最容易踩的坑：clientX/Y 在页面滚动时不会变，但 pageX/Y 会变。如果你存了一个点击位置，用户滚动后再回放，你需要 pageX/Y 而不是 clientX/Y。

DPI 缩放：坐标为什么会偏

如果你写过在一台电脑上完美运行、到另一台就偏几个像素的脚本，几乎可以肯定是 DPI 缩放的问题。这一节专门讲这个，因为这是最常见的问题，而答案并不直观。

现代显示器经常使用大于 100% 的缩放比例。一台 4K 笔记本屏幕设为 150% 缩放，报告给大多数应用的逻辑像素数比实际物理像素少：3840x2160 面板在 150% 下报告 2560x1440。问题在于，不同层级的软件栈可能用不同单位报告坐标：

• 系统级 API（如 Win32 GetCursorPos）通常返回物理像素
• Web 浏览器通过 JavaScript 报告 CSS 像素（逻辑像素）
• 自动化框架如 PyAutoGUI 试图匹配操作系统，但基于浏览器的工具可能做转换

结果：系统级脚本报告的 (1000, 500) 在 150% 缩放的浏览器里可能对应约 (667, 333) CSS 像素。如果你的脚本从系统读取坐标但点击浏览器内部，坐标就对不上了。

多显示器与负坐标

在多显示器系统上，主显示器左上角永远是 (0, 0)。副显示器沿你在显示设置中排列的方向延伸坐标平面。如果你的副显示器在主显示器左边，它的坐标是负数：左边显示器左上角的点可能是 (-1920, 0)。

这会让不少人意外，因为大部分坐标文档只讲正数。但负坐标完全合法，所有操作系统都是这样处理多显示器布局的。脚本调用 pyautogui.click(-500, 300) 会点击主显示器左边的那台屏幕。

还有一个坑：不同分辨率或缩放比例的显示器会产生"死区" -- 光标到不了的区域，因为显示器在那行或那列对不齐。这很正常，不是 bug，三大操作系统都这样处理混分辨率多显示器。

完整分析见 多显示器坐标指南。

方法对比表

常见问题