pyautogui vs pywinauto 完整对比

目录

1. 1、基础简介
   1. pyautogui
   2. pywinauto
2. 2、对比表格
3. 3、优缺点总结
   1. pyautogui
   2. pywinauto
4. 4、选型建议（UI 自动化测试）
5. 5、一句话记忆

1、基础简介

pyautogui

跨平台键鼠模拟库，基于屏幕像素，模拟人操作鼠标、键盘。
原理：移动光标、发送按键；识图功能是对屏幕截图做模板匹配。

平台：Windows / Mac / Linux
核心：只认屏幕画面，不识别软件控件

pywinauto

Windows 专属桌面 UI 自动化库，调用 Windows 原生 API（UIA / Win32），读取程序控件树。
原理：直接和窗口控件交互，类似辅助阅读工具读取界面元素。

平台：仅 Windows
核心：识别按钮、输入框等控件对象，不依赖屏幕画面

2、对比表格

对比项	pyautogui	pywinauto
底层原理	模拟鼠标键盘；像素截图匹配图像	Windows UIA/Win32 API，读取控件树
支持平台	Windows、macOS、Linux（跨平台）	仅 Windows
是否依赖屏幕画面	✅依赖，窗口遮挡 / 最小化基本失效	❌不依赖，部分场景最小化仍可操作控件
定位方式	屏幕绝对坐标、图像模板识别	窗口标题、AutomationId、控件 Name、类名
读取界面文本	困难，需要额外 OCR	直接读取控件.text()
稳定性	低。分辨率、DPI、界面配色一变脚本就挂	高。窗口位置移动，不影响控件定位
核心能力	图像识别点击、截图、键鼠模拟	等待控件、判断元素存在、读取控件属性、菜单操作
适用软件	游戏、自研渲染无控件界面、跨平台脚本	Windows 标准桌面客户端（Qt/WPF/ 记事本等）
配套定位工具	截图工具（自己截模板图）	Accessibility Insights、Inspect、py_inspect
安装依赖	pyautogui pillow opencv-python	pywinauto

3、优缺点总结

pyautogui

✅优点

1. 跨平台，Windows、Mac、Linux 都能用
2. 可以图像识别，对付没有控件的界面
3. 上手简单，坐标点击快速写 demo

❌缺点

1. 窗口被遮挡、最小化，脚本失效
2. Windows 高 DPI 缩放容易坐标偏移
3. 界面按钮样式稍微改动，图像识别失败
4. 无法直接读取页面文字

pywinauto

✅优点

1. 控件定位，稳定性高，UI 微调不影响脚本
2. 可读取控件文本、判断元素是否存在
3. 部分场景窗口最小化依然可以操作
4. 支持等待控件、弹窗处理，适合自动化测试

❌缺点

1. 只能 Windows，不能跨平台
2. 纯自研渲染界面（部分 Electron、游戏）没有 UIA 控件，识别不到

4、选型建议（UI 自动化测试）

1. 优先 pywinauto：Windows 标准桌面程序做自动化测试，稳定性最好，维护成本低。
2. pyautogui 做兜底：当软件界面没有 UIA 控件，pywinauto 识别不出控件时，再使用 pyautogui 图像识别。
3. 混合方案：pywinauto 负责找到窗口，pyautogui 限定在窗口区域内识图点击。

5、一句话记忆

1. pywinauto：找控件，Windows 桌面自动化首选
2. pyautogui：点屏幕，像素模拟，用来兜底无控件界面

---

转载请注明来源，欢迎对文章中的引用来源进行考证，欢迎指出任何有错误或不够清晰的表达。