Debug对象报错undefined，尝试多种调用写法仍无法找到，如何定位？

1. 版本差异说明 #

你看到的this.game.debug写法多为Phaser 2版本的用法，Phaser 3对调试模块做了重构，debug对象默认不会直接挂载在game根节点下，且需要手动开启配置才会生成。

2. 前置配置检查 #

使用调试对象前必须先在游戏初始化配置中开启对应调试开关，以常用的Arcade物理引擎为例：

const gameConfig = {
  type: Phaser.AUTO,
  // 其他基础配置省略
  physics: {
    default: 'arcade',
    arcade: {
      debug: true // 该配置项为true时才会生成物理调试对象
    }
  }
}

如果需要使用更丰富的图形调试能力，可以额外引入调试插件后挂载到场景：

plugins: {
  scene: [
    { key: 'PhaserDebugDrawPlugin', plugin: PhaserDebugDrawPlugin, mapping: 'debugDraw' }
  ]
}

3. 正确调用路径 #

• 场景类内部调用：
  • 物理调试对象路径：this.physics.world.debugGraphic
  • 挂载调试插件后可直接调用：this.debugDraw
• 场景外部调用：
  先获取对应场景实例再访问，示例：this.game.scene.getScene('场景名称').physics.world.debugGraphic

4. 通用排查方法 #

如果上述路径都无法匹配，可直接打印根对象查看层级结构：

console.log(this.game)

在浏览器控制台展开打印结果后，直接搜索debug关键词，即可快速定位到当前版本实际的调试对象挂载路径。

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