Phaser 入门:从安装到第一个游戏
理解 Phaser 的核心结构与工作流,完成开发环境搭建,并用 JavaScript 制作一个可交互、可计分的网页小游戏。
- 1
安装开发环境
打开官网并进入 Examples,下载 Node.js 与代码编辑器;在终端运行 node -v,确认 Node.js 已正确安装并可执行。
- 2
创建项目目录
在终端新建 phaser-demo 文件夹,进入目录后执行 npm init -y,再运行 npm install phaser,生成包含 Phaser 依赖的 package.json。
- 3
建立游戏画布
创建 index.html,引入 phaser.js,并在页面放置 id 为 game 的 div;随后新建 main.js,使用 new Phaser.Game 配置画布宽高、背景色和场景。
- 4
编写首个场景
在 main.js 中继承 Phaser.Scene,定义 preload、create、update 方法;create 中添加文本和矩形,让游戏元素显示在画布中。
- 5
加入移动与交互
使用 this.input.keyboard.addKeys 保存方向键引用,在 update 中读取按键并移动精灵;再用 this.input.on('pointerdown') 响应鼠标点击。
- 6
运行并验证结果
在项目目录执行 npm install,再运行 npx http-server -p 8080;浏览器打开 localhost:8080,测试移动、点击和计分显示。
💡 实用技巧
- 用浏览器开发者工具查看报错信息
- 先使用固定尺寸画布便于调试
- 场景切换可拆分关卡与界面
- 素材放入 assets 并统一管理路径
⚠️ 常见坑
- 脚本顺序错误会导致 Phaser 未定义
- 精灵坐标与刚体中心可能不一致
常见问题
Q:安装后提示找不到 Phaser 依赖怎么办?
先确认终端已切换到 phaser-demo 项目目录,再执行 npm install phaser。安装完成后检查 package.json 中是否出现 phaser 依赖,然后运行 npm install 并用 npx http-server -p 8080 启动项目。
Q:按方向键没有反应,代码该怎么检查?
确认场景继承了 Phaser.Scene,并在 preload、create、update 中编写代码;用 this.input.keyboard.addKeys 保存方向键引用,在 update 中读取按键状态并修改精灵坐标。若仍无效,可在浏览器开发者工具中查看报错。
Q:素材放在哪里,路径写错会出现什么问题?
把图片等素材放入项目中的 assets 文件夹,并统一使用相对路径引用。加载资源时在 preload 中配置路径,在 create 中使用对应键创建游戏元素;路径错误会导致素材无法显示,应同时检查控制台错误。