登录社区云，与社区用户共同成长
邀请您加入社区
申请人反复调整摊位类别时需要撤销最近一次修改里有一个看似不起眼的约束：把同一个对象引用同时用作当前值和历史快照，修改一个输入框后所有历史项一起变化。如果直接给事件回调增加更多条件，短期可能看起来好用，却会让下一次需求变更更加困难。 业务行为与实现目标 撤销功能看似是一个“返回上一步”按钮，真正的核心是历史数据是否不可变。如果把当前对象引用直接推入数组，后续修改 category 时历史对象也可能被
很多人把异步竞态看成代码组织问题，实际它首先是正确性问题。市集摊位名输入时的远端重名提示一旦出现“先输入“晨光”，再改成“晨光手作”，第一个慢响应反而覆盖第二次结果，页面把合法名称标成重复”的路径，用户看到的状态就可能与系统最终处理的内容不同。 观察到的现象 异步校验的典型失败不是接口不能调用，而是返回先后顺序不可预测。用户键入“晨光”，网络请求 A 发出；随后改成“晨光手作”，请求 B 先返回可
一次很有代表性的故障发生在市集经营时段和电源申请的联合校验：单个输入框看似合法，但选择“餐饮”却未填写食品安全承诺，或者请求用电但功率留空。乍看只是某个控件或接口的行为不理想，向下追踪却会发现根本原因是数据归属和异常路径没有写成明确约定。 从一次失败现象开始 表单里最棘手的错误往往不是“某个字段没有填”，而是两个字段单独看都合法，放在一起却违反业务要求。经营类别选餐饮是合法值，承诺书未勾选也可能是
市集摊位中的经营类别与用电需求联动里有一个看似不起眼的约束：经营类别从热食改成文创后，用电功率字段虽然隐藏，旧值却被提交到后台。如果直接给事件回调增加更多条件，短期可能看起来好用，却会让下一次需求变更更加困难。 业务行为与实现目标 依赖字段的问题有时很隐蔽。申请人先选择热食并填写两千瓦，再改成只售手工饰品；界面因为显隐规则收起功率输入，但序列化程序仍可能把两千瓦原样发送。服务端看到的申请与用户最终
在社区周末市集的摊位申请页面中，最难的往往不是画出一个按钮，而是保证按钮背后的业务事实始终可靠。名称、经营类别、电源要求分散在不同组件中，新增一个字段必须同时修改视图、校验和提交逻辑。这个问题如果在原型阶段不拆开，联调以后就会成为难以复现的状态错乱。 需求从哪里变复杂 与其让三个组件各自持有一个松散的 @State，不如先问“哪一份数据是用户最终要提交的事实”。本案例中三个输入的含义不同：摊位名称
乘客切换站点或者退出公交到站页面里有一个看似不起眼的约束：已经离开的页面仍接收到旧站点响应，新的站点列表被覆盖，HTTP 请求对象没有释放导致资源积压。如果直接给事件回调增加更多条件，短期可能看起来好用，却会让下一次需求变更更加困难。 业务行为与实现目标 页面离开后旧请求回来的问题，是许多网络 UI 的经典竞态。用户刚从站点 A 切到站点 B，B 的响应先返回；几秒后 A 才回来，若处理函数不辨来
在早高峰大量乘客反复刷新公交到站预估中，最难的往往不是画出一个按钮，而是保证按钮背后的业务事实始终可靠。一遇 429 就立刻重发使限流更严重，刷新按钮和后台刷新还互相争抢配额。这个问题如果在原型阶段不拆开，联调以后就会成为难以复现的状态错乱。 需求从哪里变复杂 在早高峰，用户反复拉动刷新并不会让公交预测更准，反而可能让客户端集中发送大量请求。服务端返回 429 时，应理解为当前请求频率不被接受，立
在公交到站页的“到站信息不准确”反馈提交中，最难的往往不是画出一个按钮，而是保证按钮背后的业务事实始终可靠。乘客连点提交，或者弱网导致响应丢失，就可能出现重复反馈或重复扣减服务端配额。这个问题如果在原型阶段不拆开，联调以后就会成为难以复现的状态错乱。 需求从哪里变复杂 公交到站纠错属于写操作。用户提交了“车辆提前”反馈，网络可能已经把数据交给服务器，但响应包在回程时丢失。此时简单重发同一个 POS
一次很有代表性的故障发生在城市公交站的实时到站提示页：网络超时、服务器限流、业务无数据都会被简单显示为“加载失败”，乘客无法判断是否还能信任旧到站时间。乍看只是某个控件或接口的行为不理想，向下追踪却会发现根本原因是数据归属和异常路径没有写成明确约定。 从一次失败现象开始 到站牌一旦与网络发生关系，就出现两个时间概念：数据自身的预测时间和成功接收该预测的本地时间。断网之后，“还有三分钟”并不会因为页
很多人把资源限定词看成代码组织问题，实际它首先是正确性问题。一个面向访客的多地区活动门票说明页面一旦出现“英文环境里只有一部分按钮被翻译，另一部分仍是中文，且不同密度设备上图标样式不一致”的路径，用户看到的状态就可能与系统最终处理的内容不同。 观察到的现象 多地区项目中常见的误解是“把英文文案放到英文目录，系统肯定会选它”。真正的查找过程同时考虑设备语言、地区、方向、设备类型以及密度，匹配的限定词
讨论权限闸门之前，先问一个具体问题：用户首次拒绝相机权限后，按钮仍持续弹出请求，前台恢复后又错误沿用之前的授权结果？答案不能只从界面效果判断。展会签到台的二维码核验入口有真实操作顺序，必须从触发、运算、反馈三个环节理解。 真正需要回答的问题 用户看到“开始扫码”就点击，这是合理预期；对应用来说却有两个前置判断：当前设备与运行环境是否有可用相机能力，以及应用是否已经得到本次访问所需的授权。前者需要能
很多人把自然排序看成代码组织问题，实际它首先是正确性问题。短片剪辑师导入镜头素材后按编号查看一旦出现“普通字符串排序把 shot10 放在 shot2 前面，用户误以为文件丢失或列表顺序出错”的路径，用户看到的状态就可能与系统最终处理的内容不同。 观察到的现象 文件名字典序从字符出发，无法理解编号的数值含义。shot10 的字符“1”排在 shot2 的“2”之前，在文本上正确，却不符合剪辑师按镜
在应用中的限时投票倒计时与截止提交逻辑中，最难的往往不是画出一个按钮，而是保证按钮背后的业务事实始终可靠。单元测试依赖真实 setTimeout，运行快慢导致边界时刻不稳定，偶发失败无法复现。这个问题如果在原型阶段不拆开，联调以后就会成为难以复现的状态错乱。 需求从哪里变复杂 倒计时业务非常容易出现“在我电脑上通过，在 CI 上偶尔失败”。原因通常不是复杂逻辑，而是测试真的等了一秒，并期望任务恰好
讨论稳定定位之前，先问一个具体问题：测试脚本依赖某个 x/y 坐标，页面内容增减或不同屏幕密度使点击落在错误按钮上？答案不能只从界面效果判断。需要自动回归市政服务大厅排队取号页面有真实操作顺序，必须从触发、运算、反馈三个环节理解。 真正需要回答的问题 坐标点击是自动化的诱惑，因为录制脚本时最直观：找到按钮位置，点击那个像素。然而 UI 只要换行、增加公告或者适配窄屏，原来的坐标就可能点到另一个控件
一次很有代表性的故障发生在校园活动应用从旧版提醒设置升级到新版通知分组：旧版用单个布尔值记录提醒开关，新版拆成报名消息和活动公告，直接读新键会误把所有用户设为默认关闭。乍看只是某个控件或接口的行为不理想，向下追踪却会发现根本原因是数据归属和异常路径没有写成明确约定。 从一次失败现象开始 小型设置最容易被忽略的是演进。早期一个 notifyEnabled 能满足需求，新版要区分报名消息和活动公告，如
讨论构建档位之前，先问一个具体问题：调试版能运行却携带调试信息，发布版又可能遗失必要资源，开发者把构建命令和运行结果混在一张表里？答案不能只从界面效果判断。活动展示应用交付给现场测试人员之前的发布核查有真实操作顺序，必须从触发、运算、反馈三个环节理解。 真正需要回答的问题 把调试包发给现场测试人员是常见工程疏漏。Debug 与 Release 的差异不仅在构建耗时，而是调试信息、优化行为、产物配置
讨论日志脱敏之前，先问一个具体问题：开发期间习惯打印整个请求对象，正式环境却可能将手机号、姓名和地址混入日志？答案不能只从界面效果判断。社区服务窗口需要排查线上表单提交失败有真实操作顺序，必须从触发、运算、反馈三个环节理解。 真正需要回答的问题 遇到线上提交错误时，开发者最想看到的往往是完整请求对象，然而完整数据通常包含不应进入日志的身份信息。正确的可观测性设计不是事后搜索敏感词删除，而是在日志生
很多人把体积预算看成代码组织问题，实际它首先是正确性问题。校园运动会应用上线前发现安装包体积突然增长一旦出现“新增大图片和重复音效后产物明显变大，但团队只看源码行数，没人知道增长来自哪个目录”的路径，用户看到的状态就可能与系统最终处理的内容不同。 观察到的现象 包体积增长不一定来自新增代码。一个图片被反复拷贝到不同资源目录、一个调试素材误入正式包，可能比几百行 ArkTS 更影响最终交付。团队应从
志愿活动报名名单导出给工作人员审核里有一个看似不起眼的约束：用户填写的备注如果以等号开头，导出到电子表格后可能被解释为公式，而普通英文逗号和换行会破坏列结构。如果直接给事件回调增加更多条件，短期可能看起来好用，却会让下一次需求变更更加困难。 业务行为与实现目标 一条报名记录看起来只是几列文本，但导出的 CSV 往往会被人直接用电子表格打开。攻击者完全可以把一段公式放在可编辑的备注栏。如果导出程序把
「笔记导出器」初版最值得研究的不是页面长什么样，而是一个具体故障：后台返回后导出旧画面。我把它当作导出一致性问题，从输入、处理和输出三个方向核对，最后发现关键不在多写几个条件判断，而在于确定数据归属。 一、问题与工程边界 在「笔记导出器」里，用户首先遇到的是“后台返回后导出旧画面”。这不是换一个按钮颜色就能解决的视觉缺陷。图像导出与状态恢复如果缺少稳定约束，页面在短时间内可能看起来正常，一旦操作
本次用一个规模可控的「节点编辑器」示例讨论选中容差与命令栈。目标不是堆叠组件，而是从一次操作出发，直到数据变更、界面反馈、异常恢复都拥有明确的责任人。 一、问题与工程边界 在「节点编辑器」里，用户首先遇到的是“细线难以选中且撤销后颜色异常”。这不是换一个按钮颜色就能解决的视觉缺陷。选中容差与命令栈如果缺少稳定约束，页面在短时间内可能看起来正常，一旦操作顺序、数据规模或窗口条件发生变化，结果就会偏
如果页面里同时出现Layers和状态切换，开发者很容易只测试首次进入。但「分层画板」真正棘手的部分是：擦除一个图形却重画整张画布。本文讨论的是这个现象背后的约束和可维护的写法。 一、问题与工程边界 在「分层画板」里，用户首先遇到的是“擦除一个图形却重画整张画布”。这不是换一个按钮颜色就能解决的视觉缺陷。绘制顺序与缓存失效如果缺少稳定约束，页面在短时间内可能看起来正常，一旦操作顺序、数据规模或窗口
本次用一个规模可控的「浮动预览」示例讨论子窗口开关与资源释放。目标不是堆叠组件，而是从一次操作出发，直到数据变更、界面反馈、异常恢复都拥有明确的责任人。 一、问题与工程边界 在「浮动预览」里，用户首先遇到的是“关闭预览后仍持有旧窗口实例”。这不是换一个按钮颜色就能解决的视觉缺陷。子窗口开关与资源释放如果缺少稳定约束，页面在短时间内可能看起来正常，一旦操作顺序、数据规模或窗口条件发生变化，结果就会
如果页面里同时出现Window Size和状态切换，开发者很容易只测试首次进入。但「画板尺」真正棘手的部分是：分屏缩窄后工具栏覆盖图层列表。本文讨论的是这个现象背后的约束和可维护的写法。 一、问题与工程边界 在「画板尺」里，用户首先遇到的是“分屏缩窄后工具栏覆盖图层列表”。这不是换一个按钮颜色就能解决的视觉缺陷。窗口断点与密度如果缺少稳定约束，页面在短时间内可能看起来正常，一旦操作顺序、数据规模
把“重复进入页面后窗口处理器注册两次”放到小项目里重现并不难；难的是说明它为什么会发生。围绕主窗口与 UIAbility 连接，这篇从可复现的边界入手，建立一套不依赖特定机型的检查方法。 一、问题与工程边界 在「图纸阅览」里，用户首先遇到的是“重复进入页面后窗口处理器注册两次”。这不是换一个按钮颜色就能解决的视觉缺陷。主窗口与 UIAbility 连接如果缺少稳定约束，页面在短时间内可能看起来正
把“深色模式切换后文字对比不足”放到小项目里重现并不难；难的是说明它为什么会发生。围绕主题颜色与字体缩放，这篇从可复现的边界入手，建立一套不依赖特定机型的检查方法。 一、问题与工程边界 在「展厅导览牌」里，用户首先遇到的是“深色模式切换后文字对比不足”。这不是换一个按钮颜色就能解决的视觉缺陷。主题颜色与字体缩放如果缺少稳定约束，页面在短时间内可能看起来正常，一旦操作顺序、数据规模或窗口条件发生变
把“读屏把图标读成无意义字符”放到小项目里重现并不难；难的是说明它为什么会发生。围绕标签与阅读顺序，这篇从可复现的边界入手，建立一套不依赖特定机型的检查方法。 一、问题与工程边界 在「导医分诊屏」里，用户首先遇到的是“读屏把图标读成无意义字符”。这不是换一个按钮颜色就能解决的视觉缺陷。标签与阅读顺序如果缺少稳定约束，页面在短时间内可能看起来正常，一旦操作顺序、数据规模或窗口条件发生变化，结果就会
如果页面里同时出现File Cache和状态切换，开发者很容易只测试首次进入。但「地图瓦片柜」真正棘手的部分是：中断写入留下不完整缓存。本文讨论的是这个现象背后的约束和可维护的写法。 一、问题与工程边界 在「地图瓦片柜」里，用户首先遇到的是“中断写入留下不完整缓存”。这不是换一个按钮颜色就能解决的视觉缺陷。写入中断与缓存清理如果缺少稳定约束，页面在短时间内可能看起来正常，一旦操作顺序、数据规模或
本次用一个规模可控的「活动签到页」示例讨论启动参数幂等消费。目标不是堆叠组件，而是从一次操作出发，直到数据变更、界面反馈、异常恢复都拥有明确的责任人。 一、问题与工程边界 在「活动签到页」里，用户首先遇到的是“重复唤醒导致签到操作被执行两次”。这不是换一个按钮颜色就能解决的视觉缺陷。启动参数幂等消费如果缺少稳定约束，页面在短时间内可能看起来正常，一旦操作顺序、数据规模或窗口条件发生变化，结果就会
如果页面里同时出现Navigation和状态切换，开发者很容易只测试首次进入。但「工位预约」真正棘手的部分是：连续点击生成相同详情页。本文讨论的是这个现象背后的约束和可维护的写法。 一、问题与工程边界 在「工位预约」里，用户首先遇到的是“连续点击生成相同详情页”。这不是换一个按钮颜色就能解决的视觉缺陷。路由去重与参数校验如果缺少稳定约束，页面在短时间内可能看起来正常，一旦操作顺序、数据规模或窗口
「票据索引」初版最值得研究的不是页面长什么样，而是一个具体故障：筛选后卡片闪动且选中态错位。我把它当作列表一致性问题，从输入、处理和输出三个方向核对，最后发现关键不在多写几个条件判断，而在于确定数据归属。 一、问题与工程边界 在「票据索引」里，用户首先遇到的是“筛选后卡片闪动且选中态错位”。这不是换一个按钮颜色就能解决的视觉缺陷。稳定标识与差量刷新如果缺少稳定约束，页面在短时间内可能看起来正常，
本次用一个规模可控的「海报墙」示例讨论占位比例与失败降级。目标不是堆叠组件，而是从一次操作出发，直到数据变更、界面反馈、异常恢复都拥有明确的责任人。 一、问题与工程边界 在「海报墙」里，用户首先遇到的是“图片加载后列表整体跳动”。这不是换一个按钮颜色就能解决的视觉缺陷。占位比例与失败降级如果缺少稳定约束，页面在短时间内可能看起来正常，一旦操作顺序、数据规模或窗口条件发生变化，结果就会偏离预期。一
如果页面里同时出现Grid和状态切换，开发者很容易只测试首次进入。但「城市导览卡」真正棘手的部分是：小屏卡片文字被压缩。本文讨论的是这个现象背后的约束和可维护的写法。 一、问题与工程边界 在「城市导览卡」里，用户首先遇到的是“小屏卡片文字被压缩”。这不是换一个按钮颜色就能解决的视觉缺陷。卡片列数与触控目标如果缺少稳定约束，页面在短时间内可能看起来正常，一旦操作顺序、数据规模或窗口条件发生变化，结
本次用一个规模可控的「批量审核窗」示例讨论确认动作与取消动作分离。目标不是堆叠组件，而是从一次操作出发，直到数据变更、界面反馈、异常恢复都拥有明确的责任人。 一、问题与工程边界 在「批量审核窗」里，用户首先遇到的是“误触关闭后批量结果丢失”。这不是换一个按钮颜色就能解决的视觉缺陷。确认动作与取消动作分离如果缺少稳定约束，页面在短时间内可能看起来正常，一旦操作顺序、数据规模或窗口条件发生变化，结果
「折叠日程卡」初版最值得研究的不是页面长什么样，而是一个具体故障：用户连点导致卡片半开半关。我把它当作动画中断问题，从输入、处理和输出三个方向核对，最后发现关键不在多写几个条件判断，而在于确定数据归属。 一、问题与工程边界 在「折叠日程卡」里，用户首先遇到的是“用户连点导致卡片半开半关”。这不是换一个按钮颜色就能解决的视觉缺陷。状态提交与动画中断如果缺少稳定约束，页面在短时间内可能看起来正常，一
搜索框已经输入“桂花”，列表却忽然回到上一次“桂”的结果。输入框没有丢字，过滤函数也没有写错，真正发生的是两次异步操作按相反顺序结束。调饮台最后一篇处理这条时序边界：触发搜索只是开始，结果能否进入页面，还必须再次确认它属于当前输入。 一、把故障拆成三个独立问题 搜索过程中至少有三件事：观察输入变化、决定何时启动检索、决定哪一次结果可以发布。@Monitor 解决第一件事，防抖计时器减少第二件事的重
“取消”按钮关闭了编辑区，订单却已经变成大杯。这个问题无需追查动画，也与按钮是否响应无关：编辑区与正式订单指向同一个对象，用户每次选择都已经写入正式值。要让取消真正生效，必须先改变数据关系，让未确认的修改有自己的存放位置。 一、先识别隐藏在赋值里的共享引用 上一阶段的调饮台采用即时修改，点击杯型就写入订单，这与当时的交互目标一致。现在产品需要用户连续修改杯型、冷热和加料，最后一次确认。新的需求不是
总价可以有两种来源：每点一次按钮就更新一个金额变量，或者根据当前规格重新得到金额。前一种方案开始很直观，直到加料、数量、优惠都能改变价格，每个入口都要记得再算一遍。调饮台这一阶段不增加新的写入状态，而是让订单保持原样，把费用明细定义为订单的派生结果。 一、派生值为什么不该成为第二份订单 第01篇已经定义 DrinkOrder，第02篇建立了杯型输入与事件。现在继续沿用 MixLab、API 12
把杯型按钮抽成子组件，看起来只需要剪切一段界面代码。真正容易出错的是剪切之后的赋值：子组件拿到整张订单，点“大杯”时直接改父对象；另一个规格组件又悄悄改糖度。页面虽然正常更新，修改来源却越来越难找。这一篇沿用调饮台订单，把组件之间的关系写成明确的输入和输出。 一、先把要抽取的交互说清楚 我们只抽取杯型选择器，约定它知道当前杯型、提供中杯与大杯两个选项，并把用户的选择交还给页面。它不知道订单价格，不
一杯桂花乌龙有饮品、杯型、糖度、冰量、加料和数量六组选择。把它们分别挂在按钮上，页面很快就会出现两个版本的答案：规格卡显示中杯，底部摘要还保留大杯。问题通常不在刷新速度，而在状态究竟由谁持有、一次选择应该修改哪些字段。这套调饮台交互工程先确定订单的所有权，再逐步加入组件拆分、计价、草稿编辑与异步搜索。 一、先画出状态的所有权 工程名使用 MixLab，采用 Stage 模型和 ArkTS 声明式页
“加一个导出按钮”很容易被理解成复制数据库文件。可器材簿正在写入时，数据可能还关联着日志文件；一份能看到扩展名的文件，也不代表其中的表、版本和库存关系适合恢复。系列最后一篇从恢复决策倒推备份设计：先确认什么样的数据可以接管当前库，再安排文件生成、隔离预检、覆盖前保留和恢复后的重新查询。 一、先限定恢复承诺 本篇使用前四篇的 API 14 工程和数据版本二，采用官方 RdbStore.backup(
同一份借用流水，第一页显示正常，翻到第二页却又看见刚刚读过的记录，这不一定是列表组件复用了错误的节点。只要分页使用偏移量，而两次查询之间又插入了新记录，后面的行号就可能整体移动。器材簿已经有可靠的借还事务，本篇把观察对象换成查询边界：在数据持续变化时，究竟怎样定义“下一页”，以及一轮浏览应该包含哪些记录。 一、用一个小实验分开三种稳定性 继续使用 API 14 和第三篇的数据版本二，索引为 LOA
新版器材簿想增加“存放区域”，需求只多了一个输入项，数据库却多出一条分叉：新安装的用户没有旧表，老用户的表里没有这个字段。直接把建表语句改成新版，再补一个 CREATE TABLE IF NOT EXISTS，老用户仍然得不到新列。更麻烦的是升级只执行了一半，版本号却已经变成新版；下一次启动看似不必升级，实际查询仍然失败。迁移的核心不是执行多少条语句，而是失败之后还能否准确判断当前结构。 一、把版
把库存减一，再插入借用记录，看起来只有两行代码。危险恰好藏在两行之间：第二步失败后，界面少了一件器材，却没有人能够解释它借给了谁。如果用户因为等待过久又按了一次按钮，另一类问题还会出现——同一次借用被记录两遍。本篇沿着这段最短的写入路径，拆开“原子提交”和“重复请求”两个独立问题，再把它们放回器材簿的仓库边界。 一、先写出不能被破坏的等式 延续第一篇 GearLedger 工程与 API 14 基
