pywinauto 离线安装包

简介

pywinauto 是一组用于自动化 Microsoft Windows 图形界面的 Python 模块，最基础的能力是向窗口和对话框发送鼠标与键盘动作，把点击按钮、输入文本、选择菜单项这类人工操作写成脚本步骤。它针对的是只能靠界面交互、没有接口可调的 Windows 桌面程序，适合做 PC 端界面自动化测试与桌面重复操作脚本化的测试人员和开发者。核心优势是提供 WIN32 与 MS UI Automation 两种访问技术，可按被测应用的技术栈选择对应后端。

核心功能

• 向指定窗口与控件发送鼠标、键盘动作，把点击、输入、菜单选择等人工步骤转成可重复执行的脚本。
• 提供 WIN32 访问技术，支持 MFC、VB6、VCL 以及用简单 WinForms 控件开发的应用，覆盖较老的桌面技术栈。
• 提供 MS UI Automation 访问技术，作为访问应用的另一条路径，与 WIN32 后端并列，可按被测程序切换。
• 以 Python 模块集合的形式组织，脚本可与已有的 Python 测试代码、命令行调度方式组合起来运行。
• 支持在线渠道获取，可执行 pip install -U pywinauto，或执行 conda install -c conda-forge pywinauto。
• 支持离线获取：从 Python 官网下载压缩包，进入各组件目录执行 python setup.py install，不依赖外网。
• 官方文档与源码仓库公开可查：https://pywinauto.readthedocs.io/en/latest/ 与 https://github.com/pywinauto/pywinauto

使用场景

• PC 端软件界面自动化测试：对 Windows 标准图形界面程序做回归验证，覆盖点击按钮、输入文本、选择菜单项等操作。
• 无外网机器的环境准备：内网测试机访问不了 PyPI 时，用离线压缩包逐个把组件部署到位。
• 老旧技术栈应用的自动化：被测程序基于 MFC、VB6、VCL 或简单 WinForms 时，走 WIN32 访问技术接入。
• 重复性桌面操作脚本化：把每天固定流程的窗口操作写成脚本，交给调度器按时执行，替代人工点选。
• 与坐标型工具的取舍：需要按控件而非屏幕坐标定位时选用 pywinauto；坚持固定坐标则要窗口最大化并锁定分辨率（如 1920×1080）。

安装与获取步骤

1. 确认前提：机器为 Windows，已装好 Python（素材建议使用 python3.5 以上版本），并确认 pip 能正常使用。
2. 选定获取方式：联网机器执行 pip install -U pywinauto，或执行 conda install -c conda-forge pywinauto；无联网机器从 Python 官网下载压缩包。
3. 备齐离线组件：来源页面写明需要准备四项，其中明确列出的是 pyWin32、Comtype、pywinauto 三项，完整清单以来源页面为准。
4. 部署 pyWin32：双击该组件，直接点下一步即可完成。
5. 部署 Comtype 与 pywinauto：分别进入对应文件夹，在该目录下执行 python setup.py install，两个组件各执行一次。
6. 验证结果：在目标机器启动 python 交互环境并导入 pywinauto，能正常导入即说明组件已就位；若报错则回到第 3 步核对组件是否齐全。

与同类方案的区别

• 对比 PyAutoGUI：PyAutoGUI 按屏幕坐标操作，窗口大小一变坐标就失效，需要把窗口最大化并固定分辨率（如 1920×1080）；pywinauto 先访问应用再定位窗口与控件，不依赖固定坐标。
• 拦截情况：素材指出部分软件会拦截 PyAutoGUI 的模拟键鼠，这类程序改用 pywinauto 前应先跑一个最小脚本实测，能否通过以实测结果为准。
• 对比 Clicknium：检索素材中存在 Clicknium 与 pywinauto 的对比文章，具体差异点以该文章和各自官方页面为准，本页不代为下结论。
• 在线与离线两种获取方式：pip install -U pywinauto 一条命令即可完成；离线方式需下载压缩包并按组件逐个执行 python setup.py install，步骤更多，但不依赖外网。

注意事项

• pywinauto 面向 Microsoft Windows 的图形界面，非 Windows 平台没有对应目标界面，不适用。
• 后端要与被测应用技术栈匹配：MFC、VB6、VCL、简单 WinForms 走 WIN32；其余应用的适用情况以官方文档为准。
• 执行 python setup.py install 必须先进入对应组件文件夹，目录不对会找不到 setup.py。
• 离线组件清单以来源页面 https://www.cnblogs.com/Reclouds-shangri-la/p/9229556.html 为准，素材只明确了 pyWin32、Comtype、pywinauto 三项。
• 版本与发布信息以官方页面为准：官方文档标题标注为 0.6.8，源码仓库为 https://github.com/pywinauto/pywinauto。
• 在线方式依赖 pip 可用；pip 不可用时改走离线路径，先确认本机 Python 解释器本身能正常启动。