为什么改了 note.author.name，另一台设备没反应？

第一篇做了标题同步，跑通了。这篇加复杂数据：作者、标签、编辑状态、光标位置。

结果加了之后发现问题：改了嵌套属性，另一台设备没反应。

最开始以为是 bug，后来查文档才知道：分布式数据对象的最小同步单元是根属性，不是深层属性。

一、根属性是最小同步单元

先看数据结构：

noteObj.author = {
  name: '张三',
  avatar: 'xxx'
}

如果你直接改 noteObj.author.name = ‘李四’，这个不会同步。

因为分布式数据对象的最小同步单元是根属性，也就是 author 整个。你要改 author，就得整个根属性重新赋值：

// 这样才会同步
noteObj.author = {
  name: '李四',
  avatar: 'xxx'
}

二、为什么是这个设计

为什么设计成根属性是最小单元？

因为如果每个深层属性都同步，数据量太大了，性能也不好控制。根属性作为一个整体同步，简单高效。

这段代码解决什么问题： 正确更新复杂对象。
文件： distributed/NoteObject.ets
用途： 跨设备笔记同步
接入位置： 笔记编辑

// 正确做法：整个根属性更新
updateAuthor(name: string, avatar: string) {
  // 先读出来，改完再整体赋值
  let oldAuthor = this.noteObj.author;
  let newAuthor = {
    name: name,
    avatar: avatar
  };
  this.noteObj.author = newAuthor;
}

三、change 回调怎么用

change 回调返回的是变化的根属性字段：

noteObj.on('change', (fields: string[]) => {
  // fields 是变化的根属性名
  // 比如 ['title', 'author']
  console.log('变化字段:', fields);
  
  // 根据变化字段局部刷新 UI
  if (fields.includes('title')) {
    this.refreshTitle();
  }
  if (fields.includes('author')) {
    this.refreshAuthor();
  }
});

不要 change 一触发就整个页面刷新。根据变化的字段，局部刷新对应区域就行。

四、几个容易踩的坑

第一个坑：直接修改深层属性却期待自动同步。改了 author.name，根本不同步。

第二个坑：一个巨大 Object 装下所有状态。数据太复杂，维护起来特别麻烦。

第三个坑：change 一触发就整体刷新页面。性能差，也没必要。

第四个坑：把临时 UI 状态也跨设备同步。滚动位置、光标位置这些不需要同步。

这次做复杂对象同步最大的体会是：分布式数据对象的同步粒度是根属性，不是每个深层属性都同步。设计数据结构的时候就要想好：哪些是根属性，哪些是临时状态。