NodeVideo 预览卡顿的真正原因：渲染缓存

NodeVideo 预览卡顿不是故障：首次播放需逐帧渲染缓存，进度条变绿后即流畅。解释缓存失效机制。

"预览播放卡顿、音乐和画面不同步"是 NodeVideo 被问得最多的问题。官方 FAQ 的回答非常直接：NodeVideo 的核心功能是高质量合成与渲染，而非实时流畅剪辑预览。

缓存的机制

• 第一次播放时，App 需要逐帧渲染并生成缓存——进度条会逐渐变绿
• 进度条变绿的部分，第二次及后续播放通常就非常流畅，音视频也完全同步
• 关键：任何修改（调整关键帧、添加特效、移动素材）后缓存都会失效，需要重新渲染一遍

正确的心理预期

把"预览卡"理解为"正在计算"，而不是"出了 bug"。图层多、特效重的项目首次播放慢是正常现象；频繁修改参数会不断打断缓存，这也是连续编辑时感觉卡顿的主因。

想从源头减少卡顿

官方给了一整套调优方案：降低预览帧率、预览质量、控制素材规格等，见提高预览流畅度的设置。项目过于复杂导致闪退的，见闪退的排查与缓解。