Pywinauto Windows 桌面应用 Python 自动化实战

# 通过索引查找
btn = win['保存']

# 通过属性查找
btn = win.child_window(auto_id='SaveButton', control_type='Button')

等待机制

自动化脚本最怕的就是元素还没加载完就操作。务必加上等待逻辑。

# 等待元素可见且启用
btn.wait('ready', timeout=10)

# 自定义等待函数
def is_visible():
    return win.is_visible()

wait_until(10, 0.5, is_visible)

鼠标与键盘

当控件级操作无法满足需求时，可以使用坐标级的鼠标操作。

from pywinauto.mouse import mouse

# 点击指定坐标
mouse.click(coords=(x, y))

# 滚动滚轮
mouse.scroll(coords=(x, y), wheel_dist=1)

键盘输入方面，type_keys 比 send_keys 更常用，因为它不依赖焦点窗口。

# 输入文本
win.type_keys('hello world')

# 带延迟输入
win.type_keys('你好', pause=1)

# 虚拟键码
win.type_keys('{ENTER}')
win.type_keys('^a')  # Ctrl+A

实战案例：微信自动发消息

下面是一个完整的场景示例，演示如何连接微信并发送消息。这里的关键在于验证消息是否发送成功，通常通过检查消息列表的数量和内容来实现。

from datetime import datetime
from pywinauto.application import Application

# 1. 连接微信进程
app = Application(backend='uia').connect(process=2832)

# 2. 定位聊天窗口
win = app.window(title='文件传输助手', control_type='Window')
win.wait('visible')

# 3. 记录发送前的消息条数
message_list = win.child_window(title='消息', control_type='List')
count_before = message_list.item_count()

# 4. 构造唯一消息内容（使用时间戳避免重复）
msg_content = 'Test Message ' + str(datetime.now().timestamp())
edit_box = win.child_window(title='输入', control_type='Edit')
edit_box.click_input()
edit_box.type_keys(msg_content, with_spaces=True)

# 5. 点击发送
send_btn = win.child_window(title='发送 (S)', control_type='Button')
send_btn.click_input()

# 6. 验证结果
# 发送后消息数量可能增加 1 条或 2 条（取决于时间戳显示）
count_after = message_list.item_count()
assert count_after == count_before + 1 or count_after == count_before + 2

# 获取最后一条消息内容校验
last_msg = message_list.get_item(row=count_after - 1).window_text()
assert last_msg == msg_content

总结

Pywinauto 在处理 Windows 桌面应用自动化时非常强大。关键在于理解控件树结构，合理选择后端，以及做好异常处理和等待机制。实际开发中，建议结合 UISpy 等工具辅助调试控件定位。