winwait指令用于等待窗口出现或激活，支持按标题、类名、进程名匹配，并可设超时；winwaitactive要求窗口必须激活；组合条件可提升识别可靠性。
如果您希望AutoHotkey脚本在执行后续操作前，先确认某个窗口已存在并处于活动或就绪状态，则需要使用WinWait指令。该指令会暂停脚本运行，直到目标窗口满足指定条件（如标题、类名、进程名等）出现，或超时终止等待。以下是实现此功能的多种方法：
一、使用WinWait基础语法等待窗口标题匹配
WinWait默认依据窗口标题进行匹配，适用于标题固定且唯一的情况。它支持模糊匹配和通配符，适合大多数常规窗口识别场景。
1、在脚本中输入WinWait指令，后接窗口标题字符串，例如：WinWait, 记事本
2、若需限定等待时间（单位为毫秒），在标题后添加逗号与超时值，例如：WinWait, 记事本, , 5000
3、脚本将在5秒内持续轮询，一旦检测到标题含“记事本”的窗口即继续执行；超时则跳过等待直接运行下一行
二、通过窗口类名（Class）精准等待避免标题干扰
当多个窗口标题相似或动态变化时，使用窗口类名可提升识别稳定性。类名通常不变且由系统分配，可通过Window Spy工具获取。
1、启动AutoHotkey安装目录下的Window Spy.exe工具
2、将鼠标悬停于目标窗口上，记录其“Class”字段值，例如：Notepad
3、在脚本中使用WinWait指令配合ahk_class参数：WinWait, ahk_class Notepad
4、如需设置超时，写为：WinWait, ahk_class Notepad, , 3000
三、结合进程名（PID或Exe名）等待特定程序窗口
当同一程序可能打开多个同名窗口，或需确保仅等待某进程创建的窗口时，可用ahk_exe参数锁定目标进程，防止误匹配其他程序的同名窗口。
1、确定目标程序的可执行文件名，例如：chrome.exe 或 notepad.exe
AI 舌诊面诊问诊医疗系统 + 诊疗商城系统源码是一套结合 AI 辅助诊断与商品转化的健康类程序，基于浩创云、ThinkPHP（PHP）开发，支持微信服务号与 H5 端，适合做中医舌诊面诊问答、健康建议推送以及配套诊疗商品的运营。
2、编写WinWait语句：WinWait, ahk_exe chrome.exe
3、加入超时控制：WinWait, ahk_exe notepad.exe, , 10000
4、该方式确保仅等待由chrome.exe启动的窗口，即使其他程序窗口标题也含“Chrome”也不会触发
四、使用WinWaitActive替代WinWait以等待激活状态
WinWait仅检测窗口是否存在，而WinWaitActive进一步要求该窗口必须处于前台激活状态。适用于需用户交互前确保焦点已在目标窗口的操作流程。
1、编写WinWaitActive指令，格式与WinWait一致：WinWaitActive, 无标题 - 记事本
2、添加超时参数：WinWaitActive, ahk_class CabinetWClass, , 8000
3、若等待期间窗口虽存在但未被激活，脚本将持续挂起直至其获得焦点或超时
五、组合条件等待：同时指定标题与类名提高可靠性
单一条件可能因系统弹窗、临时标题变更等导致误判。组合标题与类名可显著降低误匹配概率，尤其适用于企业软件或定制化界面。
1、用Window Spy获取目标窗口的完整标题与类名，例如标题为“数据导出完成”，类名为“#32770”
2、构造WinWait语句：WinWait, 数据导出完成, , 6000
3、增强写法：WinWait, 数据导出完成 ahk_class #32770, , 6000
4、注意：标题与类名之间用空格连接，不可加逗号
