runwait命令可阻塞脚本执行直至外部程序退出，支持路径处理、返回码捕获、工作目录与窗口模式设置、带参命令行调用，并提供run+循环检测的替代方案。
如果您希望在AutoHotkey脚本中启动一个外部程序，并确保脚本暂停执行直到该程序完全退出，可使用RunWait命令。以下是实现此功能的具体操作步骤：
一、基础RunWait语法与路径处理
RunWait命令会阻塞脚本执行，直至调用的程序终止；它支持绝对路径、相对路径及环境变量引用。若路径含空格或特殊字符，必须用双引号包裹可执行文件路径。
1、在脚本中输入RunWait后接可执行文件路径，例如：RunWait "notepad.exe"
2、若程序位于非系统路径，需提供完整路径：RunWait "C:\Windows\System32\calc.exe"
3、对含空格路径使用双引号包裹：RunWait "D:\My Tools\app.exe"
4、可结合A_ScriptDir引用当前脚本所在目录：RunWait "" A_ScriptDir "\tool.exe"
二、捕获返回码并进行条件判断
RunWait执行完毕后会将被调用程序的退出代码存入ErrorLevel变量，可用于判断程序是否正常结束或识别错误类型。
1、调用程序后立即检查ErrorLevel值：RunWait "cmd.exe /c exit 5", , Hide
2、使用If语句判断返回码：If (ErrorLevel = 5) { MsgBox, 程序以退出码5结束 }
3、区分成功与失败状态：RunWait "ping -n 1 127.0.0.1", , Hide ; 若网络不通，ErrorLevel可能非零
4、将ErrorLevel保存至临时变量以便后续多处使用：exitCode := ErrorLevel
三、指定工作目录与窗口模式
通过第三个参数可控制程序运行时的工作目录，第二个参数可设定起始目录，第四个参数决定窗口显示方式，避免弹窗干扰或路径解析异常。
1、显式设置工作目录为程序所在位置：RunWait "update.bat", "D:\Updater\", , UseErrorLevel
AI 舌诊面诊问诊医疗系统 + 诊疗商城系统源码是一套结合 AI 辅助诊断与商品转化的健康类程序，基于浩创云、ThinkPHP（PHP）开发，支持微信服务号与 H5 端，适合做中医舌诊面诊问答、健康建议推送以及配套诊疗商品的运营。
2、隐藏窗口运行并等待：RunWait "pythonw.exe script.py", , Hide
3、以最小化窗口启动并等待：RunWait "chrome.exe --headless --dump-dom https://example.com", , Min
4、强制使用脚本同级目录作为工作路径：RunWait "process.exe", A_ScriptDir, , Hide
四、处理带参数的命令行程序
当目标程序需接收命令行参数时，整个命令字符串须作为单一参数传入RunWait，且各部分间空格需准确保留，引号嵌套需转义。
1、传递简单参数：RunWait "msiexec.exe /i ""installer.msi"" /quiet"
2、组合变量与参数：exePath := "C:\App\tool.exe", args := "--mode=full --log=C:\temp\out.txt", RunWait exePath " " args
3、使用Cmd /C执行复合命令并等待：RunWait "cmd.exe /c echo Hello & pause", , Hide
4、转义内部双引号：RunWait "powershell.exe -Command ""Write-Host 'Done'; Exit 0""", , Hide
五、替代方案：Run + Loop检测进程
当RunWait不适用（如需超时控制或后台监控），可用Run启动进程后循环查询其是否存在，配合Process Exist指令实现等效等待逻辑。
1、使用Run获取PID：Run "notepad.exe", , , OutputVarPID
2、进入循环检测进程是否仍在运行：Loop { If !ProcessExist(OutputVarPID) Break, Sleep 100 }
3、定义ProcessExist函数（需提前声明）：ProcessExist(PID) { Process, Exist, %PID% ; 返回PID或0 }
4、添加超时保护：startTime := A_TickCount, timeoutMs := 30000, Loop { If (A_TickCount - startTime > timeoutMs) Break ; 超时退出 }
