本页目录
官方资料整理 Windows Linux macOS

PixiJS 开发与测试环境部署

配置 Node.js 与 PixiJS v8 开发环境,本地预览 2D Web 游戏项目。

适用项目: 引擎通用(暂未关联具体项目)

工具版本:Node.js 20 LTS、pixi.js v8

未标注「站长实测」的步骤请自行核验。

本篇为 PixiJS 通用环境教程。文档:pixijs.com/docs。v7 与 v8 API 有差异,打开旧仓库前先看依赖版本。

1. 准备 Node 环境

安装 Node.js LTS,确认 node / npm 可用。若公司网络限制,可配置 npm 镜像后再安装依赖。

2. 脚手架或官方模板验证

可按官方 Getting Started 使用打包工具创建应用,并安装:

npm install pixi.js

编写创建 Application、添加 Sprite 的最小页面,npm run dev 后浏览器应显示画面。

3. 打开现有开源项目

  1. 安装依赖并启动开发服务器(命令以 README 为准)。
  2. 资源路径、打包 public 目录、资产清单(spritesheet)错误是最常见黑屏原因。
  3. 若锁定在 Pixi v7,不要随意升到 v8;需要升级时按官方迁移说明改导入与插件。