Godot 4 TileMapLayer 入门：从图集、碰撞到可玩的 2D 关卡

OK，OK，大家好，欢迎大家来到大鹏 AI 教育，我是张大鹏。

第一次做 2D 关卡，最容易走的弯路是把每一块地砖都当作独立图片摆进场景。十几块还能忍，几百块以后，场景树、碰撞和修改成本都会迅速失控。

这篇文章只完成一个目标：把一张地砖图集变成可绘制、可碰撞、可运行验证的 TileMapLayer 关卡。

TileMapLayer 到底解决什么

一张图集里通常包含草地、墙面、拐角、装饰等小图块。TileSet 负责描述"有哪些地块以及它们具有什么属性"，TileMapLayer 负责回答"这些地块画在场景的哪些格子里"。

可以把工作流记成：

在场景中添加 TileMapLayer，然后在检查器中新建 TileSet 资源。

这里有两个尺寸必须分清：

如果原图每块是 16×16，而 TileSet 配成 32×32，自动切分一定会错位。先确认素材尺寸，再填写 TileSet 的 Tile Size。

把地砖图片拖进 TileSet 面板，创建 Atlas Source。Godot 会按照 Tile Size 在原图上显示切分网格。

检查切分是否正确时，不要只看第一行。尤其要观察边缘地块、拐角地块和带透明区域的装饰物，确认网格线没有穿过有效像素。

如果切分错位，优先检查：

关卡"看起来有墙"并不代表角色会被挡住。我们还要在 TileSet 中创建物理层，然后为需要阻挡角色的地块绘制碰撞多边形。

推荐从最简单的矩形地块开始。碰撞轮廓只覆盖实体部分，草尖、阴影、透明留白通常不应算作阻挡区域。

斜坡和不规则石块可以使用多边形，但顶点越多并不一定越准确。过度复杂的碰撞形状会增加维护成本，也可能让角色移动产生细碎卡顿。

完成 TileSet 后，回到 TileMapLayer 的绘制模式，从调色板选择地块，在视口网格上绘制。

我通常按下面的顺序搭建：

一开始不要急着把地图画满。先做一条可以从起点走到终点的短路线，运行验证后再扩展。

一个完整关卡通常不只有一层。可以按职责拆分：

拆层的价值不只是视觉排序。你可以单独隐藏、锁定、调整或替换某一类内容，不必在同一层里小心挑选。

不要只在编辑器里看地图。把上一篇的 CharacterBody2D 角色放进场景，实际走一圈：

关卡编辑的"完成"不是画面好看，而是画面、碰撞和玩法一致。

TileMapLayer 的重点不在"把图块画出来"，而在建立一条稳定的关卡生产链：TileSet 管理地块定义，Atlas 管理图集切分，物理层管理碰撞，多个 TileMapLayer 管理地图职责。

你做 TileMapLayer 时最容易卡在哪一步：图集切分、碰撞配置，还是多层遮挡？欢迎把具体问题发到评论区。