企业官网建设流程全解析

1. 项目概述：为什么选择Godot 4.2作为你的第一个游戏引擎？

如果你正在寻找一个免费、开源、功能强大且学习曲线相对平缓的游戏引擎来开启你的游戏开发之旅，那么Godot 4.2绝对是一个值得你投入时间的选择。我接触过不少引擎，从早期的Flash到Unity，再到现在的Godot，最终选择它作为教学和原型开发的主力，原因很简单：它足够轻量、设计理念清晰，并且完全免费，没有任何商业授权费用的后顾之忧。对于独立开发者、学生或者仅仅是出于兴趣的爱好者来说，这无疑是最友好的起点。

这次我们要做的项目是《Dodge the Creeps!》，一个非常经典的2D躲避游戏。玩家控制一个角色在一个固定的场景中移动，目标是躲避从屏幕四周不断生成的、向你移动的敌人。这个项目麻雀虽小，五脏俱全，它几乎涵盖了2D游戏开发的所有核心概念：场景（Scene）与节点（Node）的构建、玩家输入处理、物理碰撞检测、敌人AI（虽然简单）、游戏状态管理（开始、进行中、结束）以及用户界面（UI）的搭建。通过完成这个项目，你不仅能熟悉Godot编辑器的基本操作，更能建立起对Godot核心工作流——“节点树”和“场景继承”——的深刻理解。

网上有很多教程，但很多是基于Godot 3.x的，或者步骤跳跃太大，让新手在配置环境、理解概念时就踩坑放弃。这篇指南的目标就是充当你的“保姆”，我会基于最新的Godot 4.2稳定版，带你一步步走完全程，并重点标注那些我亲自踩过、或者新手最容易栽跟头的“坑”，确保你能顺畅地从零到一，看到自己的第一个游戏跑起来。

2. 环境准备与项目初始化：避开第一个大坑

万事开头难，而游戏开发的开头，往往就难在环境配置和项目创建上。这一步走稳了，后面会顺利很多。

2.1 Godot 4.2引擎的下载与安装

首先，访问Godot引擎的官方网站。这里有个小技巧：官网提供了多个版本，对于新手，我强烈建议下载“Standard”版本，而不是“Mono”版本。Mono版本支持C#，功能更强大，但需要额外配置.NET环境，对于纯粹的新手来说，这无疑是增加了不必要的复杂度。我们先用GDScript（Godot自家的脚本语言，语法类似Python，非常易学）来入门，等熟悉了引擎再考虑C#也不迟。

下载完成后，你得到一个可执行文件（Windows是.exe，macOS是.app，Linux是.x86_64）。Godot是便携式的，无需安装，直接运行即可。我建议你为它创建一个专门的文件夹，比如D:\GodotEngine，然后把可执行文件放进去。这样做的好处是，未来升级版本时，你可以直接下载新版本放到同级目录，互不干扰，也方便管理。

注意：避免把Godot引擎放在路径包含中文或特殊字符的目录下，虽然新版本对此兼容性好了很多，但为了杜绝一切潜在问题，使用纯英文路径是最稳妥的选择。

2.2 创建你的第一个Godot项目

运行Godot，你会看到项目管理器。点击右上角的“New Project”按钮。

1. 项目名称与路径：在“Project Name”里输入DodgeTheCreeps（或者你喜欢的任何名字）。在“Project Path”里，点击“Browse”按钮，创建一个全新的、空的文件夹来存放你的项目。例如D:\MyGames\DodgeTheCreeps。绝对不要选择一个已有文件的文件夹，或者直接指向桌面。
2. 渲染器选择（关键坑点！）：这是Godot 4.x相比3.x最大的变化之一，也是新手最容易迷惑的地方。你会看到“Renderer”选项，默认可能是“Forward+”或“Mobile”。对于我们的2D游戏《Dodge the Creeps!》：
   • 选择 “Compatibility” 渲染器。这是为兼容性而设计的渲染器，对硬件要求极低，能确保你的2D游戏在几乎所有电脑上都能正常运行，且渲染逻辑更接近Godot 3.x，学习资料匹配度更高。
   • 避免在初期选择 “Forward+”。它是为高端3D图形设计的，虽然也能做2D，但可能会引入一些不必要的复杂性和潜在的显示问题。先求稳，再求好。
3. 其他设置：剩下的选项如“Version Control”可以暂时不管，直接点击窗口右下角的“Create & Edit”按钮。

项目创建成功后，Godot编辑器主界面就会打开。如果你没看到预期的界面，或者编辑器看起来很卡，请立刻检查上一步的渲染器是否选错了。

2.3 认识Godot编辑器界面

花几分钟熟悉一下界面，这对后续操作至关重要。主要面板包括：

• 场景面板（左上）：以树形结构显示当前打开的场景的所有节点。这是我们工作的核心区域。
• 文件系统面板（左下）：显示项目文件夹中的所有文件。
• 视图面板（中间）：2D编辑器视图，你可以在这里直观地布置你的游戏世界。
• 检查器面板（右侧）：当你选中场景面板或2D视图中的某个节点时，这里会显示该节点的所有属性和参数，供你调整。
• 底部面板：包含“输出”、“调试器”、“动画”等有用工具。

3. 核心场景与节点构建：理解Godot的“乐高”哲学

Godot的核心思想是“节点（Node）树”。你可以把每个游戏对象（比如玩家、敌人、墙壁、UI文字）都想象成一个具有特定功能的节点。通过将这些节点像搭积木一样组合成一棵树，就形成了一个“场景（Scene）”。游戏就是由一个或多个场景组成的。

3.1 创建主游戏场景（Main Scene）

我们的游戏需要一个主场景来容纳一切。

1. 在“场景”面板中，你会看到一个默认的“Node2D”根节点。右键点击它，选择“Rename”，改名为Main。这将是我们的主场景根节点。
2. 在文件系统面板中，右键点击res://（代表项目根目录），选择“新建” -> “文件夹”，创建一个名为scenes的文件夹。这是为了保持项目结构清晰。
3. 确保“场景”面板中的Main节点被选中，然后点击编辑器菜单栏的“场景” -> “保存场景”，将它保存到scenes文件夹下，命名为main.tscn。.tscn是Godot场景文件的格式。

现在，我们的主场景就创建好了。接下来，我们要为它添加子节点。

3.2 构建玩家（Player）场景

玩家是一个独立的、可重用的游戏对象，我们应该将它创建为一个单独的场景，然后在主场景中“实例化”它。

1. 在“场景”面板，点击左上角的“+”号添加一个子节点。搜索并选择CharacterBody2D。为什么是CharacterBody2D而不是RigidBody2D或Area2D？因为CharacterBody2D是专门为需要由代码精确控制移动（如平台游戏角色、顶视角角色）而设计的物理体，它允许我们处理碰撞，但运动逻辑完全由我们编写的脚本决定，非常适合我们的玩家角色。
2. 将新节点重命名为Player。
3. 选中Player节点，在检查器面板中，点击“CollisionShape2D”属性旁边的“[空]”下拉框，选择“新建 CircleShape2D”。这为玩家添加了一个圆形的碰撞形状。在2D视图中，你可以看到一个白色的圆形轮廓，拖动其边缘的橙色控制点可以调整大小。
4. 我们还需要一个视觉表现。右键点击Player节点，选择“添加子节点”，搜索并添加一个Sprite2D节点。Godot 4.2的Sprite2D节点默认没有纹理，我们需要一张图片。
5. 准备素材：你可以自己用画图工具画一个简单的圆形或方块，或者从免费的素材网站（如 Kenney.nl）下载一个简单的角色精灵图。将图片文件（如player.png）拖拽到项目文件系统的res://目录下。我建议再创建一个art文件夹来存放所有美术资源。
6. 选中Sprite2D节点，在检查器面板的“Texture”属性中，点击“快速加载”按钮（那个小文件夹图标），选择你刚导入的player.png。现在你应该能在2D视图中看到玩家的样子了。
7. 最后，将玩家场景保存为独立文件。确保Player节点是场景面板中的根节点（如果不是，右键它选择“设为根节点”），然后点击“场景” -> “保存场景为”，保存到scenes文件夹下，命名为player.tscn。

实操心得：在保存玩家场景前，务必确保Player节点是根节点。一个常见的错误是保存时根节点还是Main，这样你保存的就是整个主场景了。正确做法是，在场景面板中右键Player节点，选择“保存分支为场景”，这样能自动将其设为新场景的根节点并保存。

3.3 创建敌人（Mob）场景

敌人的创建流程与玩家类似，但有一些关键区别。

1. 新建一个场景，根节点同样是CharacterBody2D，命名为Mob。
2. 添加CollisionShape2D，形状可以选择RectangleShape2D（方形敌人）或CapsuleShape2D（胶囊形），看你的喜好。
3. 添加Sprite2D节点，并赋予一个不同的纹理（如mob.png），以便和玩家区分开。
4. 敌人需要自动移动和随机生成，这需要脚本。但现在我们先保存场景。点击“场景” -> “保存场景”，保存为scenes/mob.tscn。

3.4 布置游戏世界：添加边界与生成点

回到我们的主场景（main.tscn）。

1. 添加边界（防止玩家跑出屏幕）：我们需要一个不可见的区域来限制玩家移动。添加一个Area2D节点作为Main的子节点，命名为PlayArea。Area2D用于检测重叠，我们可以用它来定义游戏区域。
2. 为PlayArea添加一个CollisionShape2D子节点。在检查器中，将其形状设置为RectangleShape2D。在2D视图中，将这个矩形拉大到覆盖整个你希望的游戏区域（通常比屏幕稍大一点，给敌人生成留出空间）。
3. 添加入口（生成点）：敌人需要从屏幕边缘生成。添加一个Marker2D节点作为Main的子节点，命名为MobSpawnLocation。Marker2D是一个不可见的辅助节点，仅代表一个位置。我们将用它来标记敌人生成的位置。不要只放一个，我们需要多个生成点。你可以复制粘贴MobSpawnLocation节点，在屏幕的左上、右上、左下、右下等边缘位置放置多个实例，并分别命名为MobSpawnLocation1、MobSpawnLocation2等。更高效的做法是，先创建一个MobSpawnLocation，写好脚本逻辑，然后通过代码随机选择这些预设位置中的一个。

4. 编写游戏逻辑：让一切动起来

静态的场景没有意义，我们需要用GDScript为节点注入生命。

4.1 玩家控制脚本（player.gd）

双击打开player.tscn场景，选中根节点Player，在检查器面板最下方，点击“脚本”旁边的“新建脚本”按钮。保持默认名称（player.gd）和路径，点击“创建”。

现在你打开了脚本编辑器。删除默认的_ready()和_process()函数，我们将从头编写。

extends CharacterBody2D # 定义玩家移动速度，单位：像素/秒。你可以随时在检查器中调整这个值。 @export var speed: float = 400.0 func _physics_process(delta: float) -> void: # 获取输入向量。Input.get_vector() 可以同时处理键盘和手柄输入，非常方便。 # 参数分别是：左动作，右动作，上动作，下动作。 var direction: Vector2 = Input.get_vector("move_left", "move_right", "move_up", "move_down") # 计算本帧的速度。方向向量是单位向量，乘以速度得到速度向量。 var velocity: Vector2 = direction * speed # 使用 move_and_collide 或 move_and_slide 来移动角色。 # move_and_slide() 会自动处理斜坡、地面检测等，对于有重力的游戏更合适。 # 我们的游戏是顶视角，没有重力，用 move_and_collide 更直接，但 move_and_slide 也能用。 # 这里使用 move_and_slide，它返回碰撞后的实际速度，但我们这里不需要。 move_and_slide() # 注意：我们直接设置了 velocity，但 move_and_slide 会使用 CharacterBody2D 自带的 velocity 变量。 # 所以更标准的写法是： # velocity = direction * speed # move_and_slide() # 但上面的代码也能工作，因为 move_and_slide() 内部会使用节点的 velocity 属性。 # 让我们修正为更标准的写法： velocity = direction * speed move_and_slide()

保存脚本。现在我们需要设置输入映射。点击编辑器顶部菜单的“项目” -> “项目设置”，切换到“输入映射”标签页。

1. 在“动作”输入框中，输入move_left，点击“添加”按钮。
2. 选中新添加的move_left动作，点击右下角的“+”号添加事件，选择“物理键”，然后按下键盘上的A键或左方向键。
3. 重复这个过程，为move_right（D/右方向键）、move_up（W/上方向键）、move_down（S/下方向键）添加映射。

回到主场景，我们需要将玩家实例化进来。在“场景”面板中选中Main节点，然后从文件系统面板中将player.tscn拖拽到2D视图或场景面板中Main节点的下方。现在运行游戏（按F5），你应该可以用WASD或方向键控制玩家移动了！

踩坑记录：很多新手在这里会遇到玩家移动速度极快或不受控制的问题。原因通常是混淆了_process(delta)和_physics_process(delta)。_process每帧调用，帧率不固定；_physics_process在物理帧调用（默认每秒60次）。涉及物理移动和碰撞的代码，务必写在_physics_process中，否则移动速度会因帧率波动而变得不稳定。

4.2 敌人脚本（mob.gd）

打开mob.tscn，为根节点Mob创建脚本mob.gd。

敌人的逻辑是：生成时，随机选择一个方向（指向屏幕中心或随机位置），然后以恒定速度直线移动，直到离开屏幕后被销毁。

extends CharacterBody2D # 敌人的移动速度，可以在检查器中为不同的敌人类型设置不同的值。 @export var speed: float = 150.0 func _ready() -> void: # 敌人准备就绪时，我们给它一个随机的旋转和移动方向，让它看起来更多样。 # 随机旋转视觉（Sprite） $Sprite2D.rotation = randf_range(0, TAU) # TAU 等于 2 * PI，一个完整的弧度 # 随机选择一个移动方向（一个单位向量） var direction: Vector2 = Vector2.RIGHT.rotated(randf_range(0, TAU)) # 将速度设置为该方向乘以速度值 velocity = direction * speed func _physics_process(delta: float) -> void: move_and_slide() # 检测敌人是否已经移出屏幕。一个简单的方法是检查它的全局位置。 # 假设我们的游戏区域大致在 (-1000, -1000) 到 (1000, 1000) 的范围内。 # 你可以根据你的 PlayArea 大小调整这个值。 var screen_rect: Rect2 = Rect2(Vector2(-1000, -1000), Vector2(2000, 2000)) if not screen_rect.has_point(global_position): # 如果敌人不在屏幕矩形内，则销毁它，释放资源。 queue_free()

4.3 主场景控制脚本（main.gd）

这是游戏的大脑，负责生成敌人、计时、更新分数和判断游戏结束。

回到main.tscn，为根节点Main创建脚本main.gd。

extends Node2D # 通过@export将场景资源暴露在检查器，方便拖拽赋值。 @export var mob_scene: PackedScene @export var player_scene: PackedScene # 游戏状态变量 var score: int = 0 var game_running: bool = false # 节点引用，在 _ready 中获取，避免硬编码路径。 @onready var score_label: Label = $HUD/ScoreLabel @onready var timer: Timer = $MobTimer @onready var mob_spawn_locations: Array[Node2D] = [ $MobSpawnLocation1, $MobSpawnLocation2, $MobSpawnLocation3, $MobSpawnLocation4 ] @onready var hud: CanvasLayer = $HUD @onready var player: CharacterBody2D = $Player func _ready() -> void: # 初始化时，确保游戏未开始。我们通过一个“开始游戏”按钮来触发。 # 先隐藏玩家，直到游戏开始 if player: player.hide() # 连接计时器的超时信号 timer.timeout.connect(_on_mob_timer_timeout) func new_game() -> void: # 重置游戏状态 score = 0 score_label.text = "Score: %d" % score game_running = true # 显示并重置玩家位置 if player: player.show() player.position = Vector2(400, 300) # 设置到屏幕中心或某个起始点 player.velocity = Vector2.ZERO # 清除所有现有的敌人（Mob节点） get_tree().call_group("mobs", "queue_free") # 开始生成敌人的计时器 timer.start() # 更新HUD hud.update_score(score) hud.show_message("Get Ready!") func game_over() -> void: game_running = false timer.stop() hud.show_game_over() func _on_mob_timer_timeout() -> void: # 只有在游戏运行时才生成敌人 if not game_running: return # 随机选择一个生成位置 var spawn_location: Node2D = mob_spawn_locations[randi() % mob_spawn_locations.size()] # 实例化敌人场景 var mob: CharacterBody2D = mob_scene.instantiate() # 设置敌人的位置为生成点的位置 mob.position = spawn_location.position # 将敌人添加到主场景中 add_child(mob) # 可以给敌人一个随机的速度变化，增加游戏性 mob.speed = randf_range(100.0, 250.0) # 为了方便管理，将敌人加入“mobs”组 mob.add_to_group("mobs") # 每生成一个敌人，增加分数 score += 1 score_label.text = "Score: %d" % score hud.update_score(score) # 我们需要检测玩家与敌人的碰撞。这可以通过 Area2D 或直接处理信号来实现。 # 这里我们在主场景中，通过连接玩家和敌人的“body_entered”信号来处理。 # 但更常见的做法是在玩家或敌人身上添加 Area2D 来检测碰撞。 # 让我们修改玩家场景，为其添加一个 Area2D 用于检测被敌人碰到。

上面的代码引用了一些我们尚未创建的节点，比如$HUD、$MobTimer。我们需要先创建它们。

4.4 创建用户界面（HUD）

HUD（平视显示器）用于显示分数、游戏开始提示和游戏结束信息。

1. 在主场景中，添加一个CanvasLayer节点作为Main的子节点，命名为HUD。CanvasLayer可以确保其子节点始终绘制在最上层，不受游戏世界坐标影响。
2. 在HUD节点下，添加一个Label节点，命名为ScoreLabel。在检查器中，调整其“文本”为“Score: 0”，并设置字体大小、位置（如左上角）。
3. 再添加一个Label节点，命名为MessageLabel，用于显示“Get Ready!”或“Game Over”。将其放在屏幕中央，字体可以设置得大一些。
4. 添加一个Button节点，命名为StartButton，文本设为“Start Game”，放在屏幕中央下方。
5. 为HUD创建脚本hud.gd。

extends CanvasLayer # 信号，用于通知主场景按钮被按下 signal start_game @onready var score_label: Label = $ScoreLabel @onready var message_label: Label = $MessageLabel @onready var start_button: Button = $StartButton func update_score(new_score: int) -> void: score_label.text = "Score: %d" % new_score func show_message(text: String) -> void: message_label.text = text message_label.show() func hide_message() -> void: message_label.hide() func show_game_over() -> void: show_message("Game Over") # 游戏结束后，显示开始按钮，让玩家可以重新开始 start_button.show() func _on_start_button_pressed() -> void: start_button.hide() hide_message() start_game.emit() # 发射信号

回到main.gd脚本，我们需要连接HUD的信号并完善游戏流程。

# 在 main.gd 的 _ready 函数中补充： func _ready() -> void: if player: player.hide() timer.timeout.connect(_on_mob_timer_timeout) # 连接HUD的开始游戏信号 hud.start_game.connect(new_game) # 初始显示开始按钮和消息 hud.show_message("Dodge the Creeps!") hud.start_button.show() # 修改 new_game 函数开头，隐藏按钮和消息 func new_game() -> void: hud.hide_message() hud.start_button.hide() # ... 其余代码不变 ...

4.5 添加计时器和碰撞检测

1. 计时器：在主场景中添加一个Timer节点，命名为MobTimer。在检查器中，设置“等待时间”为1.0（秒），并勾选“自动开始”，我们先不勾选，由代码控制。在main.gd中我们已经引用了它。
2. 玩家碰撞检测：打开player.tscn，为Player节点添加一个Area2D子节点，命名为HitBox。为HitBox添加一个CollisionShape2D，形状可以设置为和玩家的视觉精灵差不多大或稍小。
3. 为HitBox连接body_entered信号。选中HitBox节点，在检查器右侧的“节点”标签页，找到“body_entered”信号，双击它，选择Player节点作为目标，然后会弹窗让你在player.gd中创建一个新函数。命名为_on_hit_box_body_entered。

# 在 player.gd 中添加： func _on_hit_box_body_entered(body: Node2D) -> void: # 当有物体（比如敌人）进入 HitBox 区域时，触发游戏结束。 # 我们需要通知主场景。可以通过多种方式，比如发射一个信号。 # 这里我们假设主场景会监听玩家的一个自定义信号。 # 我们先在玩家脚本顶部定义信号： # signal hit # 然后在这里发射： hide() # 玩家消失或播放死亡动画 hit.emit()

在player.gd顶部添加signal hit。然后回到主场景，选中我们实例化的Player节点，在检查器的“节点”标签页，你应该能看到它有一个“hit”信号。连接这个信号到Main节点，在main.gd中创建回调函数_on_player_hit。

# 在 main.gd 中添加： func _on_player_hit() -> void: game_over()

5. 打磨与优化：让游戏更像样

基础功能完成后，我们需要进行一些打磨，提升游戏体验。

5.1 添加音效和背景音乐

声音对游戏氛围至关重要。

1. 准备音效文件：寻找或制作简单的音效，如玩家被击中时的“hurt.wav”、得分时的“score.wav”、游戏开始的“start.wav”。将文件放入项目，例如audio文件夹。
2. 添加音频播放器：在player.tscn中，为Player节点添加一个AudioStreamPlayer2D子节点，命名为HurtSound。在检查器中，将“流”属性设置为你的“hurt.wav”文件。在_on_hit_box_body_entered函数中，在发射hit信号前，添加$HurtSound.play()。
3. 背景音乐：在主场景Main节点下添加一个AudioStreamPlayer节点（注意不是2D版本），命名为BackgroundMusic。设置其流为你的背景音乐文件，并勾选“自动播放”和“循环”。

5.2 简单的视觉反馈

1. 玩家闪烁：当玩家被击中时，可以让他闪烁几下再消失，增加反馈。这需要用到Tween节点或AnimationPlayer。AnimationPlayer更强大，但对于简单闪烁，Tween更快捷。在player.gd的_on_hit_box_body_entered函数中：

func _on_hit_box_body_entered(body: Node2D) -> void: # 禁用碰撞，防止连续触发 $HitBox/CollisionShape2D.set_deferred("disabled", true) $HurtSound.play() # 创建并运行一个闪烁动画 var tween = create_tween() tween.tween_property($Sprite2D, "modulate:a", 0.0, 0.5).set_trans(Tween.TRANS_SINE) tween.tween_callback(func(): hit.emit()) # 动画结束后发射信号

2. 敌人生成效果：可以在敌人生成时播放一个简单的缩放动画。在mob.gd的_ready函数末尾添加：

func _ready() -> void: # ... 之前的旋转和速度设置代码 ... # 缩放动画 var tween = create_tween() scale = Vector2(0.1, 0.1) # 从很小开始 tween.tween_property(self, "scale", Vector2(1.0, 1.0), 0.3).set_trans(Tween.TRANS_BACK)

5.3 游戏难度曲线

一个不变的生成速度会让游戏后期变得无聊。我们可以让敌人生成速度随着时间或分数增加而加快。修改main.gd中的_on_mob_timer_timeout函数和new_game函数。

# 在 main.gd 顶部添加一个变量 var mob_spawn_time: float = 1.0 # 初始生成间隔 func new_game() -> void: # ... 其他重置代码 ... mob_spawn_time = 1.0 timer.wait_time = mob_spawn_time timer.start() func _on_mob_timer_timeout() -> void: # ... 生成敌人的代码 ... # 每生成10个敌人，缩短一点生成间隔 if score > 0 and score % 10 == 0: mob_spawn_time = max(0.3, mob_spawn_time * 0.95) # 最快不低于0.3秒 timer.wait_time = mob_spawn_time

6. 常见问题与调试技巧实录

即使跟着教程一步步做，也难免会遇到问题。这里记录了一些我教学中学生最常遇到的坑和解决方法。

6.1 运行游戏时黑屏或只有部分元素显示

• 检查场景设置：确保你运行的是主场景（main.tscn）。在编辑器顶部，确认“当前场景”旁边显示的是main.tscn。你也可以在“项目设置” -> “应用” -> “运行”中，将主场景设置为main.tscn。
• 检查节点可见性：在场景面板中，确保关键节点（如Player、HUD）的“眼睛”图标是睁开的（可见状态）。有时脚本中的hide()操作可能意外执行了。
• 检查渲染器：如果你在非常老的集成显卡上运行，且选择了“Forward+”渲染器，可能会出现问题。回退到“Compatibility”渲染器。

6.2 玩家或敌人无法移动，或者移动异常

• 脚本未正确附加：确保player.gd脚本确实附加到了Player节点上。在场景面板选中Player节点，检查检查器底部的“脚本”属性是否指向了正确的文件。
• 输入映射错误：再次确认“项目设置” -> “输入映射”中的动作名称是否与脚本中Input.get_vector()里使用的字符串完全一致，包括大小写。“move_left”和“Move_Left”是不同的。
• 物理帧函数错误：重申一遍，移动代码必须写在_physics_process(delta)中，而不是_process(delta)。
• 碰撞形状问题：如果玩家卡住不动，检查Player和Mob的CollisionShape2D是否大小合适，以及它们是否与其他不可见的碰撞体（如PlayArea的边界）发生了意外的碰撞。可以暂时禁用其他碰撞体来排查。

6.3 敌人不生成，或者生成后立即消失

• 计时器未启动：检查MobTimer节点的“自动开始”是否被错误勾选或取消。我们的代码是在new_game()中手动启动的。确保new_game()函数被正确调用（HUD的StartButton信号连接好了）。
• 生成位置无效：检查mob_spawn_locations数组中的Marker2D节点路径是否正确。在_ready函数中打印一下数组长度和位置信息来调试：print(mob_spawn_locations.size()),print(mob_spawn_locations[0].global_position)。
• 屏幕边界判断过早：在mob.gd的_physics_process中，我们判断敌人是否离开屏幕。如果screen_rect设置得太小，敌人可能一生成就被判定为离开屏幕而被queue_free()。一个更稳健的方法是使用VisibilityNotifier2D节点。为Mob添加一个VisibilityNotifier2D子节点，并连接其screen_exited信号，在信号回调中调用queue_free()。这是Godot推荐的做法。

6.4 碰撞检测不工作

• 碰撞层和掩码：这是Godot碰撞系统中最容易混淆的部分。每个CollisionObject2D（如Area2D,PhysicsBody2D）都有“碰撞层”和“碰撞掩码”属性。简单理解：
  • 层（Layer）：这个物体自己在哪一层。
  • 掩码（Mask）：这个物体会与哪些层的物体发生碰撞。
  • 默认情况下，所有物体都在第1层，且掩码也是第1层，所以它们会相互碰撞。如果你修改了这些设置，可能会导致碰撞失效。对于这个简单游戏，保持默认值（层1，掩码1）通常即可。如果做了修改，请确保玩家的HitBox（Area2D）的“掩码”包含了敌人所在层，反之亦然。
• 信号连接错误：确保Area2D的body_entered信号正确连接到了脚本中的函数。在“节点”标签页检查连接线。也可以尝试在连接的函数里先写一个简单的print(“Hit!”)来测试信号是否被触发。
• 节点未在场景树中：确保发生碰撞的两个节点（玩家和敌人）都已作为子节点添加到了主场景树中。通过add_child()实例化的节点会自动加入。

6.5 游戏性能突然下降（卡顿）

• 敌人未及时销毁：这是最常见的原因。如果敌人离开屏幕后没有被queue_free()，它们会持续累积，计算它们的移动和碰撞会严重消耗性能。务必确保你的销毁逻辑（无论是矩形判断还是VisibilityNotifier2D）正常工作。
• 内存泄漏：虽然GDScript有垃圾回收，但不当的引用（特别是对场景树的引用）可能导致节点无法被释放。确保在移除节点时使用queue_free()，而不是free()（queue_free()更安全，会在当前帧结束后释放）。
• 复杂的实时计算：避免在_process或_physics_process中执行非常耗时的操作，比如每帧遍历一个巨大的数组。对于我们的游戏，这通常不是问题。

调试是开发的一部分，不要害怕使用print()函数输出变量值，或者使用Godot内置的调试器（底部面板的“调试器”标签页）来设置断点和单步执行。遇到问题时，先隔离问题：单独测试玩家移动、单独测试敌人生成、单独测试碰撞，一步步缩小范围，总能找到原因。

完成以上所有步骤后，你的《Dodge the Creeps!》就应该是一个功能完整、有一定可玩性的小游戏了。你可以尝试调整各种参数：玩家速度、敌人生成速度、敌人移动模式、添加更多敌人类型、设计关卡等等。这个项目就像一块敲门砖，帮你熟悉了Godot的核心工作流。接下来，你可以参考官方文档和社区教程，去探索更复杂的2D功能，比如动画状态机、粒子特效、TileMap地图编辑，甚至尝试开发一个小型的平台跳跃或RPG游戏。记住，动手做和不断试错是学习游戏开发最快的方式。