为什么改了 note.author.name另一台设备没反应第一篇做了标题同步跑通了。这篇加复杂数据作者、标签、编辑状态、光标位置。结果加了之后发现问题改了嵌套属性另一台设备没反应。最开始以为是 bug后来查文档才知道分布式数据对象的最小同步单元是根属性不是深层属性。一、根属性是最小同步单元先看数据结构noteObj.author{name:张三,avatar:xxx}如果你直接改 noteObj.author.name ‘李四’这个不会同步。因为分布式数据对象的最小同步单元是根属性也就是 author 整个。你要改 author就得整个根属性重新赋值// 这样才会同步noteObj.author{name:李四,avatar:xxx}操作是否同步noteObj.title ‘新标题’同步noteObj.author.name ‘李四’不同步noteObj.author {name:‘李四’}同步二、为什么是这个设计为什么设计成根属性是最小单元因为如果每个深层属性都同步数据量太大了性能也不好控制。根属性作为一个整体同步简单高效。这段代码解决什么问题正确更新复杂对象。文件distributed/NoteObject.ets用途跨设备笔记同步接入位置笔记编辑// 正确做法整个根属性更新updateAuthor(name:string,avatar:string){// 先读出来改完再整体赋值letoldAuthorthis.noteObj.author;letnewAuthor{name:name,avatar:avatar};this.noteObj.authornewAuthor;}三、change 回调怎么用change 回调返回的是变化的根属性字段noteObj.on(change,(fields:string[]){// fields 是变化的根属性名// 比如 [title, author]console.log(变化字段:,fields);// 根据变化字段局部刷新 UIif(fields.includes(title)){this.refreshTitle();}if(fields.includes(author)){this.refreshAuthor();}});不要 change 一触发就整个页面刷新。根据变化的字段局部刷新对应区域就行。四、几个容易踩的坑第一个坑直接修改深层属性却期待自动同步。改了 author.name根本不同步。第二个坑一个巨大 Object 装下所有状态。数据太复杂维护起来特别麻烦。第三个坑change 一触发就整体刷新页面。性能差也没必要。第四个坑把临时 UI 状态也跨设备同步。滚动位置、光标位置这些不需要同步。这次做复杂对象同步最大的体会是分布式数据对象的同步粒度是根属性不是每个深层属性都同步。设计数据结构的时候就要想好哪些是根属性哪些是临时状态。