用途:把 PixiJS v7 代码库迁移到 v8,或诊断升级后损坏的 v7 代码。技能以破坏性变更清单形式,逐项给出 v7 写法对应的 v8 替代写法,建议按顺序推进:导入 → Application 初始化 → Graphics → Text → 事件 → 着色器/滤镜 → 清理。
主要能力与关键变更:初始化改为异步,使用 const app = new Application(); await app.init({ width: 800, height: 600 }); document.body.appendChild(app.canvas);,app.canvas 取代 app.view。导入统一为单一 pixi.js 包,v7 核心 @pixi/* 子包(如 @pixi/sprite、@pixi/app)已弃用,@pixi/sound 等补充包仍可用;自定义构建用 skipExtensionImports: true 并按需导入扩展。Graphics 改为先画形状再填充,如 new Graphics().rect(0,0,100,100).fill(0xff0000).stroke({width:2,color:0x000000}),drawRect 等重命名为 rect,beginFill/lineStyle 由 fill/stroke 取代,挖孔用 cut(),GraphicsContext 取代 GraphicsGeometry。Text、BitmapText、HTMLText 改用选项对象构造。Texture.from 不再加载 URL,需先 await Assets.load。NineSlicePlane 改为 NineSliceSprite,SimpleMesh/SimplePlane/SimpleRope 重命名为 MeshSimple/MeshPlane/MeshRope。事件用 eventMode 取代 interactive,默认 'passive' 不触发事件。Ticker 回调参数为 Ticker 对象,需访问 ticker.deltaTime。Shader.from、Filter 构造改用 {gl, resources} 选项,Uniform 必须带 type。纹理 UV 修改后需依次调用 texture.update() 与 sprite.onViewUpdate()。DisplayObject 移除,改用 Container;settings、utils 命名空间移除,适配器改用 DOMAdapter.set()。
适用场景:升级 PixiJS 项目、修复升级后报错或行为异常。限制:资料未提供具体版本兼容范围、性能数据与收费信息;部分旧 API 仍作为弃用别名可用,但建议替换。