Phaser CE TypeScript 入门:从安装到首屏
通过该模板搭建基于 TypeScript、Webpack 与 Phaser CE 的网页游戏项目,完成资源加载、场景开发、发行构建及桌面端打包。
- 1
准备开发环境
安装 Node.js、npm 与 Git,确认终端可执行 node -v 和 npm -v;建议使用模板要求的较新 Node.js LTS 版本。
- 2
获取项目模板
打开 GitHub 仓库,点击 Code 后复制 HTTPS 地址;在终端执行 git clone,将仓库下载并切换到项目目录。
- 3
安装项目依赖
进入仓库根目录执行 npm install,等待 npm 按 package.json 安装 Phaser CE、TypeScript、Webpack 及相关构建插件。
- 4
启动开发构建
执行 npm run dev 启动 Webpack 开发服务器,根据终端提示打开本地地址;修改 src 中场景代码后观察自动更新效果。
- 5
创建并调试场景
在 src 下新增或修改 Phaser 场景,导入 Phaser 并创建预加载、创建和更新函数;把图片等资源放入约定目录后在 preload 中加载。
- 6
构建并打包
执行 npm run build 生成发行版文件,再按仓库说明运行 Electron 打包命令;检查输出目录并部署网页版产物。
💡 实用技巧
- 资源路径应与静态目录结构保持一致
- 开发时留意浏览器控制台的加载错误
- 提交前运行类型检查与发行构建
- 字体可改用 Google Fonts 动态加载
⚠️ 常见坑
- Node.js 版本过旧会导致依赖安装失败
- 忽略资源目录配置会触发路径或跨域错误
常见问题
Q:依赖安装失败,是不是 Node.js 版本有问题?
先在终端运行 node -v 和 npm -v 检查版本。若安装时报依赖兼容错误,请升级到模板要求的较新 Node.js LTS 版本,再删除依赖目录并重新运行 npm install。
Q:图片加载后显示不出来,先检查哪里?
确认图片已放入约定的静态资源目录,并检查 preload 中使用的路径与该目录结构一致。同时打开浏览器控制台,若出现路径或跨域错误,再核对资源目录配置。
Q:改完场景代码后页面没变化,应该怎么排查?
先确认是在 src 中新增或修改 Phaser 场景代码,并检查是否导入了 Phaser、实现了 preload、create 和 update 等函数。保存后观察开发服务器是否完成重新构建,再查看浏览器控制台报错。