HarmonyOS 云同步待办清单实践：端云一体数据同步的三个关键点

待办清单是鸿蒙应用里最经典也最容易翻车的练习。做成端云一体之后，问题会从「怎么把数据存下来」变成「两边同时改了怎么办」。这篇把我在实践里踩过的三个关键点整理出来。

一、先定数据归属：谁有最终解释权

最省事的方案是「云端为准」：本地只做缓存，启动拉取全量，改动排队上行。代价是离线时不能编辑。如果产品要求离线可用，就必须给每条记录带上版本号（或更新时间戳），同步时按版本仲裁，而不是简单地用后写覆盖。我一开始用后写覆盖，结果在两台设备上交叉编辑时丢过数据，排查了半天才发现是覆盖顺序问题。

二、同步状态要显式建模

把同步状态当成三个值来管理：已同步、待上传、冲突。UI 上最好能看出哪些条目还没落盘，否则用户关机或强杀进程后数据就没了。状态机建议只允许这三条迁移，避免出现「既在同步中又在待上传」这种含糊状态。

三、冲突处理要给人看得懂的选项

自动合并只在字段级差异时可行。整条记录冲突时，直接把两个版本并排展示，让用户选保留哪一版，比任何智能合并都可靠。实践中心那个云同步待办清单案例里，这一块是体验分最高的部分。

写在最后

端云一体的难点不在接口，而在状态。先把归属、状态、冲突三件事想清楚，再动手写代码，返工量会少很多。以上是个人实践总结，欢迎在评论区指正。