手机脚本怎么写：从需求拆解到录制回放的完整流程

AIWORK内部发布

打开脚本编辑器就急着写代码，是新手最容易踩的坑。结果往往是写到一半发现逻辑走不通，推倒重来。其实写手机脚本和开发软件一样，功夫在写之外：先把需求拆清楚，把流程画出来，再动手录制或编码，最后补上异常处理和日志，一个稳定的脚本才算完成。这篇文章按完整工作流，讲清楚从需求到上线运行的每一步。

一、需求拆解与流程画图

拿到一个自动化需求，第一件事不是想用什么工具，而是把需求拆成机器能理解的步骤。以"每天把系统里的库存数据汇总后发到工作群"为例，粗看是一个任务，拆开后是四个子流程：登录系统、导出数据、汇总处理、发送消息。每个子流程再细化到原子操作：打开哪个应用、点哪个按钮、等哪个页面出现。

拆完之后画流程图。不需要专业软件，纸笔或任意画图工具都可以，用矩形表示操作、菱形表示判断、箭头表示流向。画图的价值在于暴露问题：哪些步骤有分支？什么情况下要中断？哪些页面可能加载失败？这些问题在图上改只要几秒，在脚本里改可能要重写一大段。

最后给每个步骤标注"成功标志"——也就是这一步完成后，界面上应该出现什么可验证的变化。这个细节是后续调试和异常处理的锚点。






二、坐标模式与控件模式的选择

流程图定了，接下来给每一步选择定位方式。手机脚本里最核心的分歧就是坐标模式与控件模式之争，两者各有明确的适用边界。

坐标模式直接指定屏幕上的位置点击，优点是简单直接，不依赖控件信息，游戏画面、图片展示、WebView 里的 H5 页面往往只有这一种方式可用。缺点是极其脆弱：换一台分辨率不同的手机、系统字体大小改变、页面布局微调，坐标全部失效。

控件模式通过读取界面控件树来定位，依据文本、控件 ID、类名等属性找到目标元素。优点是适应性强，界面改版后往往仍能正确识别，配合等待机制还能判断"元素是否加载完成"。缺点是部分页面控件信息不完整，或者被应用刻意隐藏，此时控件模式就无能为力。

选择原则可以概括为：能用控件就用控件，控件不可用时退回坐标，关键流程两者混用。更稳妥的做法是控件定位失败时自动降级为坐标点击，兼顾适应性与兜底能力。另外，多设备运行的脚本必须用控件模式，坐标模式在不同设备间无法通用。






三、循环、条件与异常重试

真实世界的脚本很少是一条直线，控制流是区分"能跑的 Demo"和"能用的工具"的分水岭。

循环用于批量处理：遍历一份数据表逐条填报、对列表页反复执行"滑动—采集"直到触底。写循环时要明确终止条件，防止数据异常导致死循环。

条件用于分支处理：登录失败时重试还是跳过？库存低于阈值时发还是不发的消息？把流程图里的菱形框翻译成判断语句，每个分支都要有明确的处理动作，不允许出现"走到这里不知道干嘛"的悬空分支。

异常重试是稳定性的核心。网络抖动、页面加载慢、偶发弹窗，这些意外在长时间运行时必然出现。常见策略有三层：第一层是局部重试，单步操作失败后间隔几秒重试，连续失败三次再上报；第二层是流程重试，整个流程跑失败后从头再来，适合登录态偶发丢失的场景；第三层是降级与告警，重试无效时记录现场信息并通知维护人员，而不是静默失败。另外要给关键等待设置超时上限，避免因为一个元素永远不出现，脚本无限空等。






四、日志与运行报告

脚本跑起来只是开始，看不见运行状态的脚本等于黑盒。完善的日志体系要做到三点：记录关键节点，每次启动、登录、提交、退出都留一条带时间戳的记录；记录异常现场，失败时不仅记"失败了"，还要记录当时的界面快照、控件树、错误码，这些信息决定了排查效率；分级管理，正常流程记概要日志，异常才输出详细堆栈，避免日志文件无限膨胀。

在此之上，把单次运行的结果汇总成报告：开始时间、结束时间、处理条数、成功数、失败数、失败明细。报告可以本地留存，也可以推送到消息通道。别小看这一步，自动化项目能不能持续获得信任，往往取决于维护者能否一眼说清"昨天跑得怎么样"。长期跑批的任务，还要定期归档报告，便于回溯某一天的具体执行情况。

小结

写手机脚本的完整流程可以浓缩成四步：先拆需求画流程图，把逻辑想在前面；再按"控件优先、坐标兜底"的原则定位每一步；然后用循环、条件、重试三层控制流覆盖真实世界的意外；最后用日志和报告让运行状态可见。这套方法不挑工具，无论用可视化编排还是手写代码都适用。把流程想清楚再动手，是脚本从"偶尔能跑"走向"长期可靠"的唯一捷径。实践中遇到的具体问题，欢迎到技术论坛发帖讨论。

关于我们

海南奥世智能科技有限公司（品牌：AIWORK / AIWROK）提供 RPA 流程自动化、AIWork 智能办公自动化开发引擎、键鼠盒子（HID 模拟键鼠设备）与机械臂自动化集成服务，软件与硬件一体交付。

官方网站：www.aiwork24.com　技术论坛：bbs.aiwork24.com　技术文档：语雀 AIWORK

地址：海南省海口市美兰区海景路78号蔚蓝海语印象海天阁B-6B商务邮箱：13697573037@139.com　QQ 客服：896757558

aw792nqh

说得挺对的，我也经常踩这个坑。比如说，我写脚本的时候，本来想用坐标模式，结果换了个手机，脚本就废了。后来我学会了先画流程图，把需求拆清楚，再选择坐标还是控件模式，这样改起来方便多了。你提到的那些细节，比如成功标志，真的能帮我省不少功夫。以后写脚本前我也会先画个图试试，看看有没有问题。