PyAutoGUI 第3章 弹窗交互功能教程（GUI交互，核心3）

PyAutoGUI 弹窗交互功能教程GUI交互核心3说明本教程为 PyAutoGUI 核心操作专项教程聚焦 GUI 弹窗交互功能涵盖各类弹窗的使用方法、参数配置、返回值判断结合实操代码和场景示例适配新手入门可直接复制代码调试运行。所有操作均基于 PyAutoGUI 基础环境已安装完成若未安装可参考基础教程完成环境配置。3.1 警告弹窗 alert()警告弹窗是最基础的弹窗类型主要用于显示提示信息、警告内容仅包含一个“确认”按钮用户点击确认后弹窗关闭无返回值或返回 None适用于告知用户操作结果、异常提示等场景。1. 核心方法pyautogui.alert(text, title, buttonOK)作用弹出一个包含提示文本、标题和确认按钮的警告弹窗用户点击按钮后弹窗关闭。参数说明text必传参数弹窗中显示的提示内容字符串格式可换行用 n 实现title可选参数弹窗的标题字符串格式默认为空字符串无标题button可选参数确认按钮上的文字字符串格式默认为 OK可自定义按钮文字。示例代码基础使用自定义配置importpyautoguiimporttime# 基础配置提升脚本稳定性pyautogui.PAUSE1pyautogui.FAILSAFETrue# 1. 基础警告弹窗默认标题、默认按钮文字pyautogui.alert(操作完成,title提示,button确认)# 2. 自定义按钮文字、换行提示time.sleep(1)pyautogui.alert(text警告当前操作可能导致数据丢失n请确认是否继续,title警告提示,button我知道了)# 3. 结合前序操作显示结果提示如文件复制完成time.sleep(1)print(文件复制中...)time.sleep(2)# 模拟文件复制耗时pyautogui.alert(文件复制完成,title操作成功,button关闭)2. 注意事项警告弹窗无返回值无论用户点击按钮仅一个按钮弹窗关闭后脚本继续执行文本内容中的 n 可实现换行让提示信息更清晰避免内容过长导致弹窗显示异常按钮文字建议简洁明了如“确认”“关闭”“知道了”避免过长影响弹窗美观。3.2 确认弹窗 confirm()确定/取消返回选择结果确认弹窗包含“确定”和“取消”两个按钮用户点击不同按钮会返回对应的结果字符串格式核心用于需要用户确认的操作如删除文件、覆盖内容脚本可根据返回值判断后续执行逻辑灵活度更高。1. 核心方法pyautogui.confirm(text, title, buttons[OK, Cancel])作用弹出包含提示文本、标题和两个或多个按钮的确认弹窗用户点击某个按钮后弹窗关闭并返回该按钮的文字。参数说明text必传参数弹窗提示内容字符串格式可换行title可选参数弹窗标题默认空字符串buttons可选参数按钮文字列表默认 [OK, Cancel]可自定义按钮数量和文字如 [确认, 取消, 跳过]。返回值说明用户点击哪个按钮就返回该按钮的文字如点击“确定”返回 确定点击“取消”返回 Cancel可用于判断后续操作。示例代码基础使用返回值判断importpyautoguiimporttime pyautogui.PAUSE1pyautogui.FAILSAFETrue# 1. 基础确认弹窗默认按钮OK、Cancelresultpyautogui.confirm(是否删除当前文件,title确认操作)print(f用户选择{result})# 打印返回值方便调试# 2. 根据返回值判断后续操作time.sleep(1)ifresultOK:print(执行删除操作...)# 此处可添加删除文件的代码结合前两章的键盘/鼠标操作pyautogui.alert(文件删除完成,title操作结果)else:print(取消删除操作)pyautogui.alert(已取消删除文件保留,title操作取消)# 3. 自定义按钮3个按钮time.sleep(1)custom_resultpyautogui.confirm(text请选择操作模式,title模式选择,buttons[手动模式,自动模式,退出])ifcustom_result手动模式:pyautogui.alert(已切换至手动模式,title模式切换)elifcustom_result自动模式:pyautogui.alert(已切换至自动模式,title模式切换)else:pyautogui.alert(即将退出程序,title退出提示)2. 注意事项按钮列表 buttons 可自定义数量至少1个但建议不超过3个避免弹窗过于拥挤返回值严格对应按钮文字大小写、空格需完全一致判断时需注意字符串匹配避免出错若用户关闭弹窗点击右上角叉号返回值为 None建议在脚本中添加对 None 的判断避免报错。3.3 文本输入弹窗 prompt()获取用户输入文本文本输入弹窗包含一个输入框、“确定”和“取消”按钮用户可在输入框中输入文本点击按钮后弹窗关闭并返回输入的内容或 None适用于需要获取用户输入的场景如输入文件名、账号信息。1. 核心方法pyautogui.prompt(text, title, default)作用弹出包含提示文本、标题、输入框和确认/取消按钮的弹窗获取用户输入的文本并返回。参数说明text必传参数弹窗提示内容告知用户需要输入什么title可选参数弹窗标题default可选参数输入框中的默认文本字符串格式用户可直接使用或修改默认为空字符串。返回值说明点击“确定”返回输入框中的文本若未修改默认文本返回默认值点击“取消”或关闭弹窗返回 None。示例代码基础使用输入值判断importpyautoguiimporttime pyautogui.PAUSE1pyautogui.FAILSAFETrue# 1. 基础文本输入弹窗无默认值file_namepyautogui.prompt(text请输入文件名无需后缀,title输入文件名)# 2. 判断输入结果执行对应操作time.sleep(1)iffile_nameisnotNone:# 排除用户取消/关闭弹窗的情况iffile_name.strip():# 判断用户是否输入空文本pyautogui.alert(文件名不能为空,title输入错误)else:print(f用户输入的文件名{file_name})pyautogui.alert(f文件将以「{file_name}.txt」保存,title确认保存)else:pyautogui.alert(已取消输入操作终止,title操作取消)# 3. 带默认值的输入弹窗简化用户输入time.sleep(1)user_namepyautogui.prompt(text请输入您的用户名,title用户登录,defaulttest_user# 默认用户名)ifuser_nameisnotNone:pyautogui.alert(f欢迎您{user_name},title登录成功)else:pyautogui.alert(登录取消,title提示)2. 注意事项输入框仅支持文本输入英文、中文、数字、符号均可无法限制输入类型需在脚本中自行判断输入内容的合法性若用户输入空格strip() 方法可去除前后空格避免因误输入空格导致后续操作异常建议对返回值为 None 的情况进行判断避免脚本因获取不到输入值而报错。3.4 密码输入弹窗 password()隐藏输入内容密码输入弹窗与文本输入弹窗功能类似区别在于用户输入的内容会被隐藏显示为星号 * 或圆点 •适用于需要输入密码、验证码等敏感信息的场景保护用户隐私。1. 核心方法pyautogui.password(text, title, default, mask*)作用弹出包含提示文本、标题、密码输入框和确认/取消按钮的弹窗获取用户输入的敏感信息输入内容会被隐藏。参数说明text必传参数弹窗提示内容如“请输入密码”title可选参数弹窗标题default可选参数输入框默认文本默认空字符串不建议设置密码默认值mask可选参数隐藏输入内容的字符默认 *可改为 • 等其他字符。返回值说明与 prompt() 一致点击“确定”返回输入的密码明文点击“取消”或关闭弹窗返回 None。示例代码密码输入验证逻辑importpyautoguiimporttime pyautogui.PAUSE1pyautogui.FAILSAFETrue# 1. 基础密码输入弹窗默认星号隐藏passwordpyautogui.password(text请输入您的密码,title密码验证,mask*# 输入内容显示为星号)# 2. 密码验证逻辑模拟登录验证time.sleep(1)correct_password123456# 模拟正确密码实际场景中需加密存储ifpasswordisnotNone:ifpasswordcorrect_password:pyautogui.alert(密码正确登录成功,title验证通过)# 此处可添加登录后的操作如打开软件、跳转页面else:pyautogui.alert(密码错误请重新输入,title验证失败)else:pyautogui.alert(已取消密码输入登录终止,title操作取消)# 3. 自定义隐藏字符改为圆点 •time.sleep(1)verification_codepyautogui.password(text请输入验证码,title验证码验证,mask•)ifverification_codeisnotNoneandverification_code6789:pyautogui.alert(验证码正确,title验证通过)else:pyautogui.alert(验证码错误或取消输入,title验证失败)2. 弹窗标题、内容、按钮文字自定义补充所有弹窗的标题、提示内容、按钮文字均可灵活自定义适配不同场景需求总结如下标题title建议简洁明了体现弹窗用途如“密码验证”“输入提示”避免过长提示内容text清晰告知用户操作目的或输入要求可使用 n 换行提升可读性按钮文字button/buttonsalert()单个按钮建议用“确认”“关闭”“知道了”等confirm()多个按钮建议用“确定/取消”“是/否”等对立文字便于用户选择prompt()/password()默认“确定/取消”无需刻意修改保持用户习惯。3. 弹窗返回值判断逻辑总结所有弹窗的返回值是脚本判断后续操作的核心需熟练掌握不同弹窗的返回值规则避免报错alert()无返回值或返回 None无需判断弹窗关闭后脚本直接继续执行confirm()返回用户点击的按钮文字字符串点击叉号返回 None需判断不同返回值执行对应逻辑prompt()返回用户输入的文本字符串点击取消/叉号返回 None需判断是否为 None 及输入内容合法性password()与 prompt() 一致返回输入的明文密码需注意密码验证逻辑及隐私保护实际场景中避免打印密码。3.5 弹窗交互实战综合场景应用结合本章所有弹窗操作编写一个综合实战脚本实现“弹窗提示 → 确认操作 → 输入信息 → 密码验证 → 结果反馈”的完整流程模拟软件登录操作确认的日常场景。实战需求弹出警告弹窗提示用户“即将进入登录界面”弹出确认弹窗询问用户“是否继续登录”若用户选择“继续”弹出文本输入弹窗获取用户名弹出密码输入弹窗获取密码验证用户名和密码弹出对应提示成功/失败若用户选择“取消”弹出提示弹窗终止操作。完整实战代码importpyautoguiimporttime# 基础配置pyautogui.PAUSE1pyautogui.FAILSAFETrue# 1. 警告弹窗提示即将进入登录界面pyautogui.alert(text欢迎使用本软件n即将进入登录界面请准备好账号密码,title欢迎提示,button进入登录)# 2. 确认弹窗询问是否继续登录login_confirmpyautogui.confirm(text是否继续登录,title登录确认,buttons[继续,取消])# 3. 根据确认结果执行后续操作iflogin_confirm继续:# 3.1 文本输入弹窗获取用户名user_namepyautogui.prompt(text请输入您的用户名,title输入用户名,defaultuser)# 判断用户名输入情况ifuser_nameisNoneoruser_name.strip():pyautogui.alert(用户名不能为空登录终止,title输入错误)else:# 3.2 密码输入弹窗获取密码passwordpyautogui.password(text请输入您的密码,title输入密码,mask*)# 3.3 验证用户名和密码模拟验证correct_nameadmincorrect_pwdadmin123ifpasswordisnotNoneanduser_namecorrect_nameandpasswordcorrect_pwd:pyautogui.alert(f登录成功欢迎您{user_name},title登录成功)# 模拟登录后的操作弹出操作提示time.sleep(1)pyautogui.alert(登录后可进行文件管理、数据查看等操作,title操作提示)else:pyautogui.alert(用户名或密码错误登录失败,title验证失败)else:# 用户选择取消登录pyautogui.alert(已取消登录程序即将退出,title操作取消)print(弹窗交互综合实战完成)实操注意事项弹窗操作会阻塞脚本执行只有用户点击弹窗按钮或关闭弹窗脚本才会继续执行需合理设置 PAUSE 间隔避免操作过快密码输入弹窗返回的是明文密码实际开发中需对密码进行加密处理如 MD5 加密避免明文存储或打印保护用户隐私需充分考虑用户的异常操作如关闭弹窗、输入空文本添加对应的判断逻辑避免脚本报错弹窗的标题、内容、按钮文字需贴合场景语言简洁易懂提升用户体验若弹窗无法正常显示需检查 PyAutoGUI 环境是否安装完整或重启脚本尝试。拓展提示弹窗交互可与前两章的键盘、鼠标操作结合实现更复杂的自动化场景比如弹窗提示用户确认后自动执行鼠标点击、键盘输入操作验证密码成功后自动打开指定软件、填写表单等。只需在弹窗返回值判断后添加对应的键盘/鼠标操作代码即可。