- 协议
- MIT
- Star 数
- 约 4.9 万(48,875)
- 最新稳定版本
- v8.23.0(2026-11-11 发布)
- 运行环境
- 支持 WebGL 或 WebGPU 的现代浏览器;下面示例使用 Node.js 22.12+ 和 Vite
Star 数、版本等数据截至 2026 年 11 月。 技术栈:JavaScriptTypeScriptWebGLWebGPU
定位
一句话:用 WebGL / WebGPU 高效绘制精灵、文字和图形,让网页拥有流畅的二维互动体验。
PixiJS 不是路由、表单或服务端框架,而是面向画布的渲染引擎。它提供场景树、纹理加载、滤镜、动画时钟和指针事件,适合把许多动态元素组织成一个可交互场景。第 2 期 Three.js 侧重三维世界;本期聚焦 PixiJS v8 的二维能力。官网现已推出独立的 PixiJS 3D 扩展,但不属于下面最小示例的依赖。
仓库链接
- 仓库:https://github.com/pixijs/pixijs
- 官网:https://pixijs.com/
- v8 文档:https://pixijs.com/8.x/guides/getting-started/intro
- 官方作品展示:https://pixijs.com/showcase
适用场景
- 适合:轻量网页游戏、互动广告、活动页面中的粒子与滤镜、二维地图或可视化编辑器。
- 也能做:和 React 等界面框架搭配,普通表单留在 DOM,复杂画面交给 PixiJS;音频、骨骼动画等可按需接入扩展。
- 不太适合:文章、后台表单、依赖原生语义和搜索收录的内容站;优先使用 HTML/CSS。需要完整物理、关卡和游戏系统时,先比较 Phaser;复杂三维项目可比较 Three.js。
上手示例
新建目录,使用 Vite 的原生 JavaScript 模板,在生成的 src/main.js 中替换为下列代码;保留模板的 index.html 入口即可。
npm create vite@latest pixi-start -- --template vanilla
cd pixi-start
npm install
npm install pixi.js@8.23.0
npm run devimport { Application, Graphics } from 'pixi.js';
const app = new Application();
await app.init({ width: 800, height: 500, background: '#14213d' });
document.body.replaceChildren(app.canvas);
const ball = new Graphics().circle(0, 0, 45).fill(0xffb703);
ball.position.set(400, 250);
ball.eventMode = 'static';
ball.cursor = 'pointer';
ball.on('pointertap', () => { ball.scale.set(ball.scale.x === 1 ? 1.4 : 1); });
app.stage.addChild(ball);
app.ticker.add(() => {
ball.x = 400 + Math.sin(app.ticker.lastTime / 800) * 180;
});橙色圆球在深蓝画布上左右移动,点击可放大或缩回。这里用 v8 的异步 app.init(),不要直接照搬 v7 的构造器初始化写法。示例不加载外部图片,方便第一次验证渲染和事件是否正常。
优点
- 二维渲染能力集中:精灵、图形、文字、滤镜和场景树在同一套 API 下工作。
- 从小例子到完整作品:官方示例和 Open Games 让学习路线不止停留在 API 文档。
- 交互不必自己从零接线:场景对象可处理指针事件,也有命中区域与层级组织能力。
- 按需求组合:可以嵌入已有网页,不必让整个网站迁移到一套游戏框架。
缺点
- 不是完整游戏引擎:物理、业务状态、关卡流程、网络同步等仍需自己设计或选配。
- 画布不是普通网页布局:无障碍、文字选择、语义与搜索收录需要额外考虑,不能认为绘制了文字就等同于 HTML。
- 显卡与资源预算仍要管理:纹理尺寸、滤镜叠加、分辨率和对象数量都会影响移动设备性能;应在目标设备上验证。
- 主版本示例不能随便混用:v8 初始化与部分 API 和旧教程不同,复制代码前先确认版本。
同类对比
| 工具 | 更适合 |
|---|---|
| PixiJS | 灵活的二维渲染、互动页面、画布编辑器与自定义游戏架构 |
| Phaser | 希望同时获得场景、输入、物理等常用二维游戏系统 |
| Three.js | 相机、光照、三维模型等空间场景 |
| HTML / CSS | 语义内容、表单、布局与原生无障碍交互 |
作品展示
以下作品均收录于官方 Showcase;官方示例和开源小游戏也便于继续读代码。
官方示例官方目录按精灵、容器、图形、文字、事件、滤镜等分类,每个示例都能打开代码并运行。建议先看 Graphics 和 Events,再尝试滤镜,而不是一次复制一个大型游戏。
在线运行PixiJS Open Games 的泡泡小游戏,从开始界面到可玩场景展示了精灵、按钮与反馈动画如何组合。与只画一个圆相比,它更接近真实游戏的项目规模。
作品展示浏览器中的二维瓦片地图编辑器,支持导入 tileset、绘制地图并导出给游戏引擎。值得看的是密集图块如何在编辑场景里保持清晰,以及画布与工具面板的分工。
作品展示Google Research 的词语联想游戏,提供 Arcade 和 Blocks 两种模式。画面把文字块、排布与动画结合起来;PixiJS 负责视觉交互并不意味着它负责游戏背后的语义模型。
作品展示另一款 PixiJS Open Games 作品,以药水主题的拼图与角色动画呈现完整的休闲游戏界面。适合和 Bubbo Bubbo 对照,观察不同美术风格下的场景组织。
