如果你跟我一样用 Godot 做 2D 小游戏，大概率会在某个晚上被这几个场景折腾到没脾气：子弹明明描边画得很大，却从敌人身体中间穿过去；想删一个临时生成的爆炸特效，结果直接报错；明明是像素风，一缩放边缘锯齿就糊成一团。这篇是系列二第 5 篇，前几篇我们解决了场景搭建、角色移动和 TileMap 地图，这一期我想集中处理“游戏真正能打起来”之前绕不开的几个底层问题：物理碰撞为什么不生效、节点到底该怎么删、2D 画面为什么发糊，以及弹幕类游戏里子弹一多就卡该怎么优化。所有代码以 Godot 4 为准，我自己用的 4.2 稳定版，3.x 的读者需要手动对照项目设置的位置。

1. 物理碰撞“神秘穿透”的排查：刚体类型、碰撞层与形状尺寸

战斗系统里最容易被误会的，就是“明明加了碰撞节点，为什么没有反应”。大多数时候不是逻辑错了，而是 Godot 物理引擎压根没把这两个物体当成应该碰撞的对象。

1.1 先确认你用的节点，是物理系统真正认识的“身体”

Godot 2D 里有几类物理相关节点，很多人一上来全用 Area2D，这其实是问题的起点。CharacterBody2D 一般用于玩家或敌方角色，它要靠脚本里的 move_and_slide() 自己移动，物理引擎负责处理它和其他碰撞体之间的阻挡；RigidBody2D 是完全交给物理引擎驱动的刚体，适合可被推开的箱子、被击飞的道具；StaticBody2D 适合墙体、地面这类静止不动的物体；Area2D 本身不参与物理阻挡，它只是“监控区域”，用来检测物体进入、离开或重叠。

如果你给一个应该被玩家撞回去的敌人用了 Area2D，然后希望它像墙一样挡住玩家，那就不可能。反过来，如果子弹需要检测敌人，却不代表子弹本身要被物理引擎“推着走”，那么子弹用 Area2D 是最合适的。常见的错误是你的子弹根本没有设置正确的 Body 类型，而是用了 Node2D + CollisionShape2D，这种组合在 Godot 4 里不会参与任何碰撞检测，因为碰撞形状必须挂在物理节点下面才有效。

Debug 时我习惯先检查：这个节点如果是 Area2D，它不会阻挡玩家，只会发信号；如果是 CharacterBody2D，有没有在 _physics_process() 里调用移动函数；如果是 CollisionShape2D，是不是被错误地加到了 Node2D 下面。把这几件事过一遍，能过滤掉一半的“穿透问题”。

1.2 碰撞层和掩码没对上：别人打不到你，多半是位运算没配好

Godot 的碰撞检测基于 layer 和 mask 两层位掩码。简单说，layer 表示“我站在这层的赛道上”，mask 表示“我看得到哪些赛道上的物体”。子弹要打中敌人，子弹的 mask 必须包含“敌人所在的 layer”，敌人的 mask 也必须包含“子弹所在的 layer”。很多人只设置了子弹的 mask，忘了敌人那边也要反向设置，结果就是监听不到进入的信号。

我在项目资源里一般先约定这张表：

墙体不需要主动检测什么，所以 mask 设为 0。玩家要在地图上走，mask 就要包含世界和敌人。敌人自身要挡住地图，同时要能被玩家子弹打中，所以 mask 里包含世界、玩家以及玩家子弹那两位。这里的数值不是随便拍的，layer 名的规则是 1、2、4、8、16，也就是二进制位从 1 开始左移，方便用位运算组合判断。

在代码里动态设置也很简单：

gdscript复制const LAYER_WORLD := 1
const LAYER_PLAYER := 2
const LAYER_ENEMY := 4
const LAYER_BULLET := 8

func setup_bullet() -> void:
    collision_layer = LAYER_BULLET
    collision_mask = LAYER_ENEMY

强烈建议在 Project Settings > Layer Names > 2D Physics 里把常用层名提前定义好，这样美术或队友接手时，看一眼检测配置就知道节点在跟谁互动，也避免靠数字猜来猜去。

1.3 形状没跟着资源走：CollisionShape2D 的尺寸和缩放比你想的更容易出问题

还有一种“看起来碰到了，其实擦边穿过”的情况，是 CollisionShape2D 的尺寸和 Sprite 不一致。新创建一个 CollisionShape2D 时，默认形状可能是一个很小的胶囊或长方形，你如果把敌人图片调大了一倍，却忘了调碰撞形状，那么子弹只有在子弹中心擦过敌人中心附近时才可能触发检测。另一个坑是父节点被缩放，子节点的碰撞形状会被一起缩放。如果美术资源的缩放比例是 2，碰撞多边形却没跟着调，那么视觉上打中了，物理上还没进入检测范围。

排查时打开编辑器上方的 Debug > Visibl