Phaser3添加状态报错：Cannot read property 'add' of undefined 求助

这个报错大概率和Phaser版本差异有关，当然也有其他可能的原因，我帮你拆解分析：

最可能的原因：Phaser版本不兼容 #

Phaser 2和Phaser 3的API变化非常大，其中状态系统就是核心差异点之一：

• 在Phaser 2中，确实是通过game.state.add()来添加游戏状态（比如Boot、Preload这些），这时候game.state是一个合法的对象。
• 但到了Phaser 3，官方彻底移除了state这个概念，换成了Scene（场景）系统，根本不存在game.state这个属性，所以直接调用game.state.add()就会抛出Cannot read property 'add' of undefined的错误。

如果教程用的是Phaser 2，而你引入的是Phaser 3，那肯定会出这个问题——这也是新手跟着旧教程用新版本框架最常踩的坑。

其他可能的原因 #

除了版本问题，还有几个小概率但值得排查的点：

• game对象未正确初始化：你可能在new Phaser.Game(...)还没执行完成、game实例还没创建好的时候，就调用了game.state.add()。比如把状态添加的代码写在了游戏初始化代码的前面，或者没有在正确的回调时机执行。
• 作用域问题导致game变量未被正确引用：如果game是在某个局部作用域里定义的（比如用let/const声明在函数内部），而你在外部作用域调用game.state.add()，这时候game会是undefined。
• Game.Boot的定义有问题：虽然报错指向的是game.state，但如果Game.Boot本身不存在，有时候也可能引发连锁问题（不过这个概率较低，优先排查前面的点）。

解决建议 #

1. 核对版本并对齐：先确认教程使用的Phaser版本，然后在你的项目中引入相同版本的Phaser。如果想继续用新版本，就得把代码改成对应版本的写法——比如Phaser 3中，你需要创建BootScene类，然后在初始化游戏时通过scene配置项传入。
2. 确保game实例已就绪：在Phaser 2中，建议把状态添加的代码放在game.onReady回调里，或者确保它在new Phaser.Game(...)之后执行。
3. 检查作用域和变量引用：确认game变量在调用game.state.add()的作用域中是可访问的，避免因作用域隔离导致的undefined。

内容的提问来源于stack exchange，提问作者Tommy_95