在 PixiJS v8 中用…

当需要在 PixiJS v8 中单次绘制调用渲染成百上千个共享同一贴图的轻量粒子（粒子特效、弹幕等）时使用。

适用场景

解决思路

1. 用 `new ParticleContainer({ texture, boundsArea, dynamicProperties })` 创建容器，并传入共享的 `texture`；若省略 texture，则回退到第一个加入粒子的贴图，且所有粒子必须共享同一基础贴图源。
2. 用 `new Particle({ texture, x, y, scaleX, scaleY, anchorX, anchorY, rotation, tint, alpha })` 创建粒子；也可直接 `new Particle(texture)` 使用默认值。
3. 通过 `container.addParticle(particle)` 添加粒子，不要用 `addChild`（会抛错）；ParticleContainer 不接受 Sprite 子对象。
4. 用 `particles` 构造选项预填充：`new ParticleContainer({ texture, boundsArea, particles })`，等价于逐个 addParticle 但跳过每次调用的视图更新。
5. 设置 `dynamicProperties` 只标记需要每帧上传 GPU 的属性（vertex、position、rotation、uvs、color）；默认仅 position 为 true，其余保持静态以提升性能。
6. 运行时修改了静态属性后，调用 `container.update()` 重新上传；批量操作时直接操作 `container.particleChildren` 数组（如 `push(...batch)` 或 `length = 0`）再调用一次 `update()`，比逐个 addParticle/removeParticle 更快。
7. 必须设置 `boundsArea`（如 `new Rectangle(0, 0, w, h)`），否则容器默认返回空 bounds `(0,0,0,0)`，会被剔除且 `containsPoint` 永远不命中。
8. 需要像素风清晰渲染时设置 `roundPixels: true`，代价是失去亚像素平滑运动。
9. 需要自定义效果时通过 `shader` 选项替换默认粒子着色器；自定义着色器必须声明 `aPosition`、`aUV`、`aColor` 以及 dynamicProperties 中启用的动态属性。
10. 用 `Particle.defaultOptions = { ...Particle.defaultOptions, anchorX: 0.5, anchorY: 0.5 }` 全局修改粒子默认值。
11. 枚举、计数和操作粒子时使用 `container.particleChildren` 数组，而非 `container.children`（后者为空）。
12. 用标准 Container 方法迁移：`addChild`→`addParticle`、`removeChild`→`removeParticle`、`addChildAt`→`addParticleAt`、`removeChildAt`→`removeParticleAt`、`removeChildren`→`removeParticles`、`getChildAt`→直接访问 `particleChildren[index]`；`swapChildren` 和 `reparentChild` 不可用。
13. 要整体淡出或染色粒子系统时，把 ParticleContainer 包进普通 Container，通过父级 `alpha`、`tint`、`blendMode` 级联到所有粒子，无需遍历 particleChildren。
14. 需要把粒子系统与背景精灵或 UI 叠加层分组时，把 ParticleContainer 本身包进普通 Container：`world.addChild(backgroundSprite, particleContainer, uiLayer)`。

适用边界 · 注意事项

• 需要每个对象拥有完整功能（滤镜、遮罩、独立混合模式、嵌套子对象、事件、变换层级）时，应使用 Sprite 而非 Particle。
• 粒子需要多个不相关的基础贴图时不可用；所有粒子必须共享同一基础贴图源（图集可以）。
• 需要自动边界计算或逐粒子混合模式时不可用，ParticleContainer 有意牺牲这些特性换取速度。