Godot 4入门教程：从安装到创建第一个2D游戏场景

我最早接触 Godot 4是因为一个独立游戏项目的原型开发需求。之前一直用其他引擎总觉得为了做一个 2D 原型要搭一套重量级环境有点杀鸡用牛刀。换到 Godot 之后光是“下载解压就能跑”这一点就让我省了不少事加上场景、节点这套设计思路对 2D 游戏特别友好我很快就决定把整套工具链迁过来。这篇内容就是给完全没接触过 Godot 的朋友准备的起步教程目标很直接把引擎装好把界面弄成中文然后亲手跑起来一个 2D 游戏场景。你不需要有任何游戏开发经验只要会下载文件、会解压就能跟着做完。整个流程走通之后你会对这个引擎的“场景—节点—脚本”工作方式有一个直观感受这也是后面做任何游戏的基础。1. 入门之前先搞清楚Godot 4 到底是什么凭什么适合做 2D 游戏真正开始安装之前我建议你先花五分钟理解一下 Godot 的本质。很多人第一次打开 Godot 会有个困惑这玩意儿怎么不像是游戏引擎更像是一个设计工具这其实是它一个很大的特点。1.1 开源免费、体积小、开箱即用Godot 是开源引擎使用 MIT 协议这意味着你用它做出来的游戏无论商业还是非商业都不需要支付任何授权费用也没有分成要求。这对独立开发者、学生、或者只是想试着做点小游戏的人来说非常友好。另一个很直观的优势是体积。现在很多引擎光安装包就几个 GB装完占磁盘十几 GB。而 Godot 本身只有几十 MB 左右不需要强制安装下载下来是一个压缩包解压之后直接双击就能运行。这个“绿色软件”式的体验让它在配置普通的电脑上也能流畅跑起来。我最初选择它还有一层原因是导出方便。Godot 支持导出到 Windows、macOS、Linux、Android、iOS、Web 等多个平台而且导出流程相对简单不涉及特别复杂的工程配置。1.2 为什么 4.x 版本值得现在入手市面上有 Godot 3.x 和 Godot 4.x 两个大版本很多教程还在用 3.x但我建议新学习者直接上 4.x。原因有几个第一渲染架构完全不同。Godot 4 引入了全新的 Vulkan 渲染器光照、阴影、材质表现都上了一个台阶对 2D 的渲染管线也做了大量优化。你现在学 3.x过段时间还是要迁移到 4.x不如一步到位。第二2D 工作流变化明显。Godot 4 的 2D 坐标系统更直观引入了 TileMapLayer 等新节点物理系统也重写了。这些改动让 2D 游戏的制作体验比 3.x 顺畅不少四个字总结就是“更跟手”。第三社区趋势。目前官方文档、插件生态、视频教程的主力方向已经全面转向 4.x搜索引擎上能搜到的新内容基本都是 4.x 的。学旧版本会遇到“搜不到答案”的窘境。1.3 标准版与 .NET 版选哪个打开官网下载页面你会发现每个版本都提供了两个选项标准版Standard和 .NET 版。这里解释一下区别。标准版内置的脚本语言是 GDScript这是 Godot 自己的动态类型脚本语言语法接近 Python专门为游戏逻辑设计。你不需要安装任何额外的运行时用什么系统就下载什么版本开箱即用。.NET 版则允许你用 C# 写游戏逻辑。如果你之前是 Unity 开发者或者团队对 C# 更熟悉可以选这个版本。但它需要你自己安装 .NET SDK整体环境配置会多一些。对于纯新手我强烈建议先用标准版。GDScript 看起来陌生但实际上手很快。它不是一门你需要“专门学”的语言更像是一个帮你说出游戏想法的工具。等你把 Godot 的逻辑搞熟了再考虑 C# 也不迟。注意标准版和 .NET 版的工程文件不通用切换版本需要迁移所以一开始想清楚就好。2. 下载安装从官网拿到对应系统版本避开常见误区安装 Godot 之所以单独拿出来讲是因为它的安装方式跟普通软件不一样。它不是那种“下一步下一步完成”的安装向导而是手动解压、指定运行文件的过程。这个区别让有些新手在第一步就卡住了。2.1 官网下载与版本选择打开 Godot 官网godotengine.org点击页面上的 Download 按钮你会看到 4.x 标准版和 .NET 版的下载入口。这里有一个小技巧官网默认展示的是最新稳定版我建议你直接选择带“stable”标识的版本不要下载 alpha、beta 或 dev 版本那些是预览版可能会遇到还没修完的 Bug。学习阶段稳定压倒一切。到这一步不管你是 Windows 还是 macOS 用户下载到的都是一个压缩包文件。Windows 是 zip 格式macOS 是 zip 或者 dmg 格式。Linux 用户则有 AppImage 等几种选择后面单独讲。2.2 Windows 安装解压即用但解压位置有讲究Windows 用户拿到 zip 包之后把压缩包解压到你想放的目录就行。但这里有个我踩过坑之后的经验尽量不要把 Godot 解压到需要管理员权限的路径比如 C 盘的 Program Files 目录。因为你之后会频繁读写项目文件、导入素材放在一个普通用户可读写的路径下更省心。我自己的习惯是放在 D:\DevTools\Godot 这样的目录。解压出来后你会看到一个 Godot_v4.x-stable_win64.exe 文件双击它就能启动引擎。为了方便之后使用右键这个 exe选择“发送到”→“桌面快捷方式”以后就不用每次都去目录里找了。首次启动时如果系统提示缺少 DLL 或者运行库通常是因为电脑缺少 Visual C Redistributable。去微软官网下载安装最新的 VC_redist.x64.exe 就能解决。2.3 macOS 与 Linux 安装差异macOS 用户下载到的通常是 zip 文件解压后得到一个 .app 格式的应用程序。双击打开时如果系统提示“无法打开因为无法验证开发者身份”需要去“系统设置”→“隐私与安全性”里点击“仍要打开”。Linux 用户我推荐下载 AppImage 格式。拿到文件后先打开终端给它添加执行权限chmod x Godot_v4.x-stable_linux.x86_64.AppImage然后双击或者用命令行启动./Godot_v4.x-stable_linux.x86_64.AppImage如果你桌面环境没有集成 AppImage 的运行环境可能还需要安装 FUSE这个属于系统差异遇到问题再针对性解决即可。经验之谈Godot 本身不提供自动更新功能后续出新版本直接下载新版解压替换就行。项目文件不受影响这一点非常省心。2.4 第一次启动项目管理器长什么样双击运行之后你会看到一个项目管理器窗口这就是 Godot 的大门。左侧是最近的项目列表右侧按钮可以新建项目、导入项目等。第一次打开时可以看到项目列表是空的这很正常。你还需要理解一个重点Godot 的“项目”不是一个文件而是一个文件夹里面装着场景、脚本、资源等所有文件。创建项目时你需要给它指定一个文件夹路径。在这一步先别急着点新建项目下一步我先帮你把界面语言切成中文看着中文界面再创建项目心里会踏实很多。3. 编辑器汉化Godot 4 内置多语言支持不需要额外汉化补丁很多从 Unity 或 Unreal 转过来的朋友一上来就到处找“汉化补丁”。其实 Godot 4 跟那些引擎不一样它从底层就内置了多语言本地化支持编辑器界面自带中文文本。所谓的“汉化”就是在设置里把语言切一下而已。3.1 语言切换的正规路径启动 Godot 后先不要创建项目。在项目管理器窗口的右上角找到“设置”按钮点击进入 Editor Settings。在左侧栏找到“界面”Interface→“编辑器语言”Editor Language在下拉框里选择“中文简体”。这里有一点要说明Godot 4 的语言选项里显示的是“中文简体”不同版本可能显示为“简体中文”本质一样。选完之后界面会立刻或重启后变成中文整个编辑器菜单、面板、属性检查器都会变成中文显示。3.2 项目和代码命名建议继续保持英文界面语言改中文没有问题但我要提醒一点项目名称、文件夹名、脚本名、节点名这些“名字”建议一律用英文。原因很现实GDScript 语法本身要求标识符使用英文字符虽然部分中文字符串可以用但文件名、节点名如果出现中文某些第三方插件或者导出流程里容易出编码问题排查起来很麻烦。我的经验是界面语言设为中文是为了降低学习门槛但工程内部“名正言顺”地用英文这是国内开发者经过无数坑之后形成的共识建议你从第一课就养成这个习惯。3.3 为什么不需要额外汉化包看到网上有人分享“Godot 4 汉化包”你要留个心眼。Godot 4 的编辑器语言切换是官方功能不需要下载任何外部汉化包。如果你下载来历不明的“美化资源”或“完整汉化包”反倒可能把配置搞乱甚至引入非官方插件导致启动报错。凡是遇到让你额外下载东西的操作优先在官方设置里找答案。界面切成中文之后可以看到文件系统面板、场景面板、节点面板全部变成了中文。这时候再开始创建项目你会发现每个选项的含义都好理解多了。4. 创建第一个 2D 游戏场景从空白场景到能动的方块这部分是重头戏。我们目标很明确创建一个 2D 场景往里面放一个图标然后给它写一段简单脚本让它能响应键盘操作。整个过程走完你就理解 Godot 最核心的“场景—节点—脚本”工作机制了。4.1 新建项目几个关键配置的含义回到项目管理器点击“新建项目”按钮填写项目名称我建议用英文比如 First2D。项目路径会自动带出你刚才填的名字你可以手动改位置。如果你之前选择了“项目文件夹”创建方式在这个界面还能看到渲染器选项。在项目创建界面有一个“渲染器”下拉选项里面有 Forward Plus、Mobile、Compatibility 三个选项。第一次接触这几个词可能有点懵简单解释一下Forward Plus功能最全的渲染器支持高级光照和特效适合做追求画质的游戏。Mobile移动端优先性能和画质平衡。Compatibility兼容模式对低端显卡和 Web 导出支持更好。对纯 2D 入门项目来说选哪个都行因为 2D 游戏对光照的要求没那么高。我建议直接使用默认的 Forward Plus后续如果发现电脑跑起来吃力再切换渲染器。创建完毕之后Godot 会打开主编辑器界面。你可以看到中间是空的视口左侧是场景面板右侧是属性检查器底部还有输出面板。现在正式开始第一个场景。4.2 添加根节点场景的起点一个场景在 Godot 里必须有一个根节点。根节点是整个场景的入口它下面可以挂任意多的子节点。在场景面板里点击顶部“场景”菜单或者直接按热键创建一个新节点。选择节点类型时我们可以搜索 Node2D。Node2D 是 2D 游戏里所有节点的基类它定义了位置、旋转、缩放这些 2D 变换属性。我给你的第一个场景起名 Main这就是根节点的名字。保存场景文件名我建议叫 main.tscn。你会发现场景保存之后就是一个纯文本文件打开能看到里面的节点树结构。这一点非常友好场景文件可以直接对比、合并、甚至手写修改。4.3 添加素材节点把图标显示出来有了根节点我们要往里面放东西。最简单的方式是拖一个图片素材进场景。在文件系统面板底部Godot 默认提供了一个 icon.svg 图标资源。直接把它拖到场景面板的 Main 节点上松开鼠标你会发现场景视图里出现了一个 Godot 图标同时场景面板里多了一个 Sprite2D 节点。这个操作的本质是创建了一个 Sprite2D 节点并把它的纹理资源指向了 icon.svg。Sprite2D 就是 2D 游戏中显示图片的节点你以后做角色、道具、背景都离不开它。此时我们可以点击场景面板顶部工具栏的“运行当前场景”按钮快捷键是 F6。你会看到游戏窗口弹出里面显示了一个居中的图标。虽然它还不会动但“运行第一个 2D 场景”这个目标已经实现了。4.4 给场景写第一段脚本让图标响应键盘一个静止的画面离“游戏”还差一步——交互。我们现在给图标加上最简单的键盘控制让它能上下左右移动。在场景面板中右键点击 Sprite2D 节点选择“附加脚本”。弹窗里可以保持默认设置直接创建。此时编辑器会自动打开脚本编辑器里面是默认生成的代码模板。这里面有几个概念先说清楚我们给 Sprite2D 挂了一个脚本文件这样一来这个节点就有了行为逻辑。在 Godot 里“节点定义是什么脚本定义怎么动”二者组合才是完整的游戏对象。在脚本里我们不需要手动写循环刷新的逻辑只需用 Godot 提供的_process方法它会在每一帧被自动调用。再利用Input.get_vector读取键盘输入弦配合节点的position属性更新位置即可。用到的代码非常简单extends Sprite2D var speed 300 func _process(delta): var direction Input.get_vector(ui_left, ui_right, ui_up, ui_down) position direction * speed * delta这段代码的逻辑direction是一个二维向量按左键时 x 为 -1按右键时 x 为 1上下同理。position是节点的位置坐标我们用它加上“方向 × 速度 × 帧时间”就能保证游戏在不同帧率下移动速度一致。保存脚本再次按 F6 运行用键盘方向键或 WASD 控制试试。你会发现那个图标能满屏移动了这就是一个最简单的 2D 互动场景。4.5 设置主场景F5 直接进入游戏刚才运行用的是 F6运行的是“当前正在编辑的场景”。如果你的项目里有多个场景每次进游戏都要先打开对应场景再按 F6这就很别扭。正确做法是把游戏入口场景指定为“主场景”。在顶部工具栏的项目设置里找到“运行”→“主场景”把 main.tscn 选上。这样以后直接按 F5就能从主场景启动游戏。这个配置对于后续开发很重要尤其是当你做了多个场景比如标题界面、关卡界面、结算界面只有明确“哪个是入口”引擎才知道启动时先加载哪个。5. 常见问题速查新手最容易踩的五个坑我在给朋友和同事推荐 Godot 的过程中积累了不少高频问题。这里集中列出来按我的经验给出解答希望能帮你少走弯路。问题可能原因解决办法双击 exe 没有任何反应缺少运行库安装 Microsoft Visual C Redistributable编辑器打开后闪退或黑屏显卡驱动或渲染器兼容性差更新显卡驱动或在项目设置里切换渲染器为 Compatibility 模式改完设置界面没变中文需要重启编辑器修改语言后重启 Godot或确认当前版本支持多语言中文输入法打不出字或卡顿有输入法兼容性问题游戏运行时切换到英文输入法代码和名称坚持用英文脚本报错说 position 不能直接赋值写脚本时继承类型不是 Node2D确认脚本extends对应的是 Sprite2D 或 Node2D 类型5.1 “编译器错误”排查思路新手写 GDScript 遇到红色报错信息是家常便饭。关键是要学会读报错信息。Godot 的报错非常人性化通常会告诉你错误发生在哪个文件第几行以及是什么类型的错误。最常见的错误是拼写不一致比如写成position direction * speed * delta却把 speed 定义成了Speed大小写不一致就会报“找不到变量”的错误。GDScript 对大小写敏感这一点和 C/C 一样也是 Python 开发者的比较容易忽略的。另一个常见问题是_process方法名写错。Godot 的内部回调方法名是固定的_process、_physics_process、_ready这些方法名必须小写开头如果你写成_ProcessGodot 不会像普通函数那样调用它游戏会表现为“没有反应”而且代码检查不一定报错。遇到这种情况优先检查方法名是否正确。建议脚本写错很正常关键是先看报错面板从第一行报错开始解决避免被后续连锁报错信息误导。5.2 显示异常与性能问题如果你用的是集成显卡的老电脑打开 Godot 后可能会出现编辑器视图花屏或者运行游戏时帧率很低。这通常是默认渲染器对显卡要求高于硬件能力导致的。这时候在项目设置里把渲染器切换成 Compatibility 模式问题一般能缓解。这个模式牺牲了一部分特效能力但兼容性和性能都更好对 2D 游戏来说基本无感。如果你的电脑配置还不错但游戏运行时画面卡顿先检查是不是在调试模式下运行。Godot 在编辑器里按 F5 运行时默认开着调试模式性能会略低于正式导出版本。真正判断性能要看导出后的实际运行效果。5.3 中文相关的一些特殊坑虽然编辑器支持中文显示但项目路径中包含中文时某些环境下可能会遇到资源导入失败的情况。比如你把项目放在 D:\游戏项目\First2D 下素材导入可能报错。这不是 Godot 故意的而是引擎底层对非英文字符路径的处理不够完善。我的建议很简单项目的绝对路径里尽量不要出现中文、空格和特殊符号整个目录结构保持英文。这个习惯会让你的 Godot 开发生涯顺畅很多尤其是到了 Android 或者 Web 导出环节很多奇怪的问题都是路径里有中文导致的。6. 迈出第一步之后你的知识版图正在形成完成这个入门场景意味着你已经打通了“项目创建—资源导入—节点搭建—脚本控制—运行调试”这条最核心的开发链路。这个链路会在你以后做任何游戏时一遍遍地用到区别只是节点更多、脚本更复杂、场景更丰富。你在这个阶段建立起来的几个基本概念比具体的操作步骤更重要。第一场景就是游戏世界的组成单位任何一个角色、关卡、UI 面板都可以是一个场景。第二节点是场景的积木不同类型的节点干不同的事但都可以挂脚本赋予行为。第三脚本是驱动逻辑的引擎GDScript 虽然看起来简单表达游戏逻辑的能力很强。我记得自己第一次跑通这个流程的时候最大的感受不是“我会做游戏了”而是“原来游戏引擎的逻辑这么清晰”。Godot 没有把一个游戏做成黑盒而是把一切都摊开给你看场景文件是纯文本资源导入规则一目了然脚本随时可以挂载和卸载。这种透明感对新手建立心智模型特别有利。接下来你可以做两件事一是改装一下这个小 Demo换一张自己喜欢的图片当主角调一调移动速度感受一下参数对游戏手感的影响二是去官方文档里挑一个入门教程系统了解一下 GDScript 的基础语法。等你搞懂了怎样在场景之间切换怎样播放动画怎样处理碰撞你就真正入门了 2D 游戏开发。