使用yjs ，editor无法正常渲染 #4804

Activity

1. Capyhw

   added

   bug

   on Dec 25, 2025
2. dosubot

   added

   plugin:yjs

   on Dec 25, 2025
3. dosubot commented on Dec 25, 2025

   

   dosubotBot

   on Dec 25, 2025 – with DosuBot

   More actions

   Hi @Capyhw! I'm Dosu and I’m helping the plate team.

   你遇到的问题是 Plate 和 Yjs 初始化时机冲突导致的。正确做法是：

   1. 创建编辑器时必须设置 skipInitialization: true，这样 Plate 不会自动初始化内容，避免和 Yjs 状态冲突。官方文档说明
   2. 在组件挂载后（比如 React 的 useEffect），手动调用 editor.getApi(YjsPlugin).yjs.init()，并传入文档 id 和初始内容。只有当 Yjs 文档是空的，初始内容才会被插入，否则会同步远端内容，不会重复追加。源码逻辑
   3. 组件卸载时记得调用 editor.getApi(YjsPlugin).yjs.destroy()，避免内存泄漏。
   4. 如果不设置 skipInitialization: true，Plate 会在 Yjs 内容还没同步时插入初始值，每次刷新都可能追加内容，导致重复。相关讨论
   5. 推荐的 React 代码模式如下：

   const editor = useMemo(() => createPlateEditor({
     plugins: [/* ... */],
     skipInitialization: true,
   }), []);
   
   useEffect(() => {
     // 等 Yjs provider ready 后再初始化
     editor.getApi(YjsPlugin).yjs.init({
       id: docId,
       value: initialValue,
     });
     return () => editor.getApi(YjsPlugin).yjs.destroy();
   }, [editor, docId, initialValue]);

   6. 如果遇到多余空段落，是因为 Plate 的规范化逻辑在 Yjs 内容还没同步时插入了空 block，这不是你的写法问题，是时机问题。可以在 Yjs 内容同步后过滤掉空段落，或者确保 Yjs provider 尽快同步内容。相关说明

   更多细节和例子可以参考 官方 Yjs 插件文档 和 协作示例。

   To reply, just mention @dosu.

   ---

   ^{How did I do? Good | Irrelevant | Incorrect | Verbose | Hallucination | Report 🐛 | Other}

      
4. felixfeng33 commented on Dec 31, 2025

   

   felixfeng33

   on Dec 31, 2025

   Last edited by felixfeng33

   Collaborator

   More actions

   我花费较多时间，将potion中的bug修复了，platejs中的还没来得及修复，有时间会修复
5. udecode

   locked and limited conversation to collaborators on Dec 31, 2025
6. zbeyens

   converted this issue into a discussion #4805 on Dec 31, 2025
7. zbeyens

   added the

   Bug

   issue type on Oct 26, 2026
8. zbeyens

   removed

   bug

   on Oct 26, 2026