
你可能已经听说过不少关于游戏引擎的讨论Unity、Unreal、Godot这三个名字常年占据热门话题榜。想入门游戏开发的人第一反应往往是先把这些引擎的安装包下载下来然后花一晚上处理各种配置问题最后还没开始写代码就累了。Godot给我的感觉完全相反官网下载一个压缩包解压后双击exe就能用没有任何安装向导不要求你注册账号也不会偷偷在你机器上装一堆运行库。这是“Godot游戏开发”系列的第一篇目标非常朴素——学习一个教程在你的电脑屏幕上显示出一个方块。如果你是完全没碰过游戏引擎的新手跟着这篇做完你会理解Godot最核心的几个概念引擎和项目的边界、场景与节点的组织方式、脚本的运行时机顺便避开我当年踩过的坑解压出0个文件、窗口拉伸变形、中文乱码。1. 第一个坑引擎下载完解压出0个文件1.1 Godot为什么能做成绿色软件第一印象往往是最大的困惑。你从官网或者GitHub下载回来的是一个zip压缩包。解压之后既没有安装向导也没有注册表写入只有一个类似于Godot_v4.x-stable_win64.exe的可执行文件放在那里就能跑。很多新手这时候会怀疑自己是不是下错了东西。其实这正是Godot的设计思路。整个引擎就是一个自带运行时的可执行程序项目资源放在独立目录里运行时由引擎读取并解析不需要侵入操作系统。这一点和很多商业引擎完全相反也让Godot可以直接放在U盘里带走。官网下载页通常有两个版本选择标准版和.NET版。新手建议选标准版。不是因为C#不好而是标准版内置的GDScript和引擎的贴合度更高写起来就像在说Godot自己的方言出错提示也更友好。等以后确实需要在项目中混用C#再换成.NET版不迟。1.2 “解压出0个文件”的完整排查链路我在搜索Godot相关内容时经常看到有人问为什么解压出来0个文件我甚至怀疑过是不是压缩包损坏。后来把问题拆开排查发现原因基本集中在三个地方。第一先确认下载的文件大小是否正常。Godot标准版win64压缩包一般在50到70MB左右如果下载下来只有几KB基本是网络中断或者浏览器缓存了不完整的文件重新下载一次就好。第二换一个解压工具试试。Windows自带资源管理器在解压某些网络下载的zip时偶尔会报错或者直接提示解压出0个文件。这种情况下用7-Zip或Bandizip打开同一个压缩包通常就好了。第三检查杀毒软件的隔离区。部分杀毒软件会把Godot主程序识别成“未知名可执行文件”直接隔离导致解压结果里空空如也。把下载目录和解压目录加入信任列表再解压一次问题立刻消失。1.3 引擎和项目的区别为什么打开exe看到的不是编辑器千辛万苦打开exe之后你看到的并不是编辑器而是一个项目管理器。这个设计很容易劝退新人我不是来开发游戏的吗怎么先让我选择项目简单说引擎exe是“空壳”它负责运行和编辑游戏但具体的游戏内容比如场景、脚本、图片、音频都存放在一个个项目文件夹里。项目管理器就是让你选择、创建和导入这些项目的地方。所以别人给你一个Godot游戏工程时你要做的不是去找某个独立的exe而是把整个工程目录拖进项目管理器或者点击Import选中目录下的project.godot文件。项目文件夹里常见的还有assets美术资源、scripts脚本和各个.tscn场景文件这些后面会慢慢接触到。顺手回答一个热门问题为什么免费商用引擎里很多人推荐Godot最核心的是它的MIT开源协议完全免费商用没有分成没有席位费功能对中小型2D/3D项目来说非常完整。对比之下Unity个人版免费但有一定收入门槛Unreal引擎有分成条款学习曲线也更陡。对入门者来说Godot最友好的不是免费本身而是“小而完整”——场景编辑器、脚本编辑器、动画、粒子、UI、音频全部内置不用为了一个功能去安装一堆扩展包。2. 创建第一个场景从窗口设置聊到节点树2.1 新建项目时的几个选项怎么选在项目管理器点击New会看到一个表单。Name填你想给项目起的名字比如MyFirstBlockProject Directory是项目存放位置。这里注意Godot习惯上每个项目单独一个文件夹不要把多个项目混在一个目录里否则项目管理器很难区分。Renderer通常默认Forward对大多数2D和中等规模的3D项目都够用。如果你的目标是做轻量级2D游戏或者要考虑低端设备兼容性Mobile模式会更快但这个阶段选默认就好。进入编辑器后新建场景时可以看到几个模板2D、3D、User Interface、空节点。选2D场景根节点会是一个Node2D这个名字听起来不直观但它就是所有2D对象的“地基”。保存场景CtrlS命名为Main.tscn。2.2 节点、场景和父子关系用乐高积木理解整个引擎Godot里的核心组织单位是节点。节点是什么你可以把它想成乐高积木的每一块有负责显示的有负责播放声音的有负责物理计算的。不同的节点组合起来就构成一个场景。场景本身又可以当成一块更大的积木嵌套进别的场景里。这种一级套一级的结构最终组成整个游戏。拿你现在的新建2D场景来说根节点只有一个Node2D。Node2D有位置、旋转、缩放这三个基础属性相当于一块空白积木。我们在它下面加子节点方块就能显示出来。子节点也可以有自己的子节点形成父子关系父节点移动子节点跟着移动父节点隐藏子节点全部隐藏。保存场景之后顺手用文本编辑器打开Main.tscn你会看到一段带缩进的文本。Godot的场景文件本质上是文本格式节点层级、属性参数都在里面。这带来一个隐藏优势方便用git做版本管理团队协作时能清楚知道谁改动了哪个节点的属性。2.3 窗口设置1280x720不是随便填的很多人第一次运行项目发现窗口要么是默认的小尺寸要么全屏后画面被拉伸变形。这是没设置设计分辨率的结果。在Project - Project Settings - Display - Window里Viewport Width和Viewport Height就是你设计画布的尺寸。我习惯用1280x720这是最常见的16:9分辨率做UI切图和适配都比较方便。下面两个关键选项经常被忽略Stretch Mode和Aspect。Mode设为canvas_itemsAspect设为keep。Mode决定游戏画面如何跟随窗口缩放canvas_items会把整个2D画布包括UI当成一张可缩放的画布而不是简单拉伸像素Aspectkeep表示保持宽高比不因为窗口形状不同而变形。这样设置之后窗口无论放大缩小方块都处在相对稳定的位置。对应的project.godot里长这样[display] window/size/viewport_width1280 window/size/viewport_height720 window/stretch/modecanvas_items window/stretch/aspectkeep3. 显示方块的三条路线我建议你从哪条开始3.1 最快看到结果用ColorRect做一个纯色方块先走最简单的一条。在场景树面板右键根节点Add Child Node搜索ColorRect添加。ColorRect是一个继承自Control的节点专门用于绘制纯色矩形。在右侧Inspector里把默认的白色改成红色然后把Layout的锚点预设设为Position也就是左上角。接着把Offset Right和Offset Bottom都改成200意思是这个矩形从坐标(0,0)延伸到(200,200)。按F6运行场景红色方块就出现在窗口左上角附近。我第一次看到这个方块时第一反应是“这也太简单了”。但简单并不代表没用ColorRect非常适合做UI背景、血条底色、按钮区块。你后面做任何界面原型都会反复用到它。不过要提醒一点ColorRect属于Control类节点它受锚点和布局规则影响。如果你直接通过代码改它的position位置可能和预期不一致。选中ColorRect在Layout菜单里明确选择Position左上再把Margin全部清空它的position才能像普通2D节点一样“指哪打哪”。3.2 游戏对象路线物理体、碰撞盒、显示形状三层组合往真正的游戏开发方向走我更推荐第二条路线。删掉ColorRect重新添加一个StaticBody2D节点重命名为Block。在这个Block下面添加CollisionShape2D在Shape属性里新建RectangleShape2D把Size改成200x200。再添加一个Polygon2D在Polygon属性里手工输入四个顶点(-100,-100)、(100,-100)、(100,100)、(-100,100)。运行场景同样是一个方块但这次它有了碰撞体积。这里的结构很有意思StaticBody2D本身不显示画面它负责物理行为CollisionShape2D不显示画面只负责碰撞形状Polygon2D才真正负责把方块画出来。三个节点叠在一起就像给游戏角色装了“骨架、碰撞盒和皮肤”。这种分层设计在Godot里非常常见理解之后后面做角色、敌人、子弹都会顺手很多。3.3 代码绘制路线一条脚本画出方块第三条路线适合后面做性能优化时再用。在根节点上右键Attach Script写三行代码extends Node2D func _draw(): draw_rect(Rect2(0, 0, 200, 200), Color.RED)运行一下方块出现了而且场景树里一个额外节点都没有。_draw是Godot的绘图回调当引擎认为需要重绘时会自动调用。draw_rect不是添加一个节点而是直接生成绘制指令。当你有成千上万个格子需要渲染时这种方式的性能开销比维护一大堆子节点小得多。3.4 三条路线怎么选我整理了一个简单对比路线节点/代码成本适合用途扩展性ColorRect1个Control节点UI、背景、按钮区块做游戏角色不自然物理体组合3个以上节点有碰撞、物理需求的游戏对象强可直接挂脚本draw_rect代码绘制1条脚本大量简单的图形渲染碰撞交互需自己处理我的建议是做界面原型用ColorRect做真正能被点击、被碰撞的游戏角色从第二条开始这才是游戏开发日常的形态。第三条是性能取向等遇到“节点太多导致卡顿”时再回过头来用。4. 给方块加脚本从静态显示到键盘操控4.1 脚本怎么挂extends到底是什么意思选中最外层的Block节点右键Attach Script语言默认GDScript路径会自动生成在项目的scripts目录下。脚本不是独立存在的神秘东西它是给节点写的一份“行为说明书”。脚本第一行extends决定了它能附着在什么类型的节点上比如extends Node2D就是给2D节点用的。挂到节点之后这个节点就拥有了脚本里定义的行为。4.2 _ready和_process一前一后两个钩子GDScript里最常用的两个回调是_ready和_process。_ready在节点进入场景树后调用一次适合做初始化_process每帧都会调用适合做持续更新。下面这段代码让方块原地匀速转动extends Node2D onready var block: ColorRect $Block func _ready(): print(场景准备好了) func _process(delta): block.rotation delta这里有两个新手容易卡住的点。首先是$Block它等价于get_node(Block)意思是“拿到当前节点下名为Block的子节点”。路径是相对于当前脚本挂载节点的不是相对于某个全局位置。其次是onready它保证拿到子节点的时机被推迟到所有子节点就绪之后避免在_ready之前就访问一个不存在的节点。运行后方块会持续转动每帧转过的弧度正好是delta。delta的单位是秒表示两帧之间的时间差所以这句代码的意思是“每秒转1弧度”在不同帧率下转速保持一致。4.3 用Input.get_axis处理键盘移动有了转动再加移动就顺理成章。把_process改成这样func _process(delta): var speed : 300.0 var input_vec : Vector2( Input.get_axis(ui_left, ui_right), Input.get_axis(ui_up, ui_down) ) block.position input_vec * speed * deltaInput.get_axis(ui_left, ui_right)返回-1到1之间的数值按左方向键得到-1按右得到1两个都不按返回0。ui_left、ui_right这些是引擎预置的输入映射可以在Project Settings - Input Map里查看和修改。speed * delta的作用是把“每秒移动300像素”换算成“这一帧该移动多远”。这就是为什么游戏里所有匀速移动的写法看起来都差不多_process delta 速度。4.4 真正的游戏角色该用CharacterBody2D还是RigidBody2D如果做的是传统平台跳跃游戏用ColorRect加手动position并不是标准做法。更常见的组合是CharacterBody2D CollisionShape2D Polygon2D脚本这样写extends CharacterBody2D export var speed : 300.0 func _physics_process(delta): var input_vec : Vector2( Input.get_axis(ui_left, ui_right), Input.get_axis(ui_up, ui_down) ).normalized() velocity input_vec * speed move_and_slide()velocity是CharacterBody2D的内置速度属性move_and_slide()负责“带碰撞地移动”它会根据velocity尝试移动撞到墙就停下来或者滑开。注意这里用的是_physics_process而不是_process因为物理相关的运算需要和物理引擎的固定频率保持一致。如果你想让方块更像现实世界里的物体可以把StaticBody2D换成RigidBody2D它会被重力拽着往下掉。再给他写一行跳跃逻辑extends RigidBody2D func _unhandled_input(event): if event.is_action_pressed(ui_accept): apply_central_impulse(Vector2(0, -600))ui_accept默认对应空格键。apply_central_impulse是给刚体一个冲击力效果是方块向上弹起。刚体不需要手动设置velocity引擎会自己模拟力、重力和碰撞反弹。为了不让方块直接掉出屏幕可以在场景底部加一条StaticBody2D CollisionShape2D当“地面”然后把RigidBody2D放在略高的位置。5. 新手最容易摔跤的三个地方乱码、节点路径、资源引用5.1 脚本里的中文乱码不是引擎的锅第一个高频问题是乱码分两种情况。第一种是脚本里的中文注释变成乱码或者直接变成“锟斤拷”。这基本是编码问题Godot的脚本要求UTF-8编码而Windows记事本在某些情况下默认保存成ANSI或GBK。解决办法是别用系统记事本写脚本换VS Code或NotePad打开文件后检查右下角编码确认是UTF-8。如果已经是GBK全选复制到新文件以UTF-8保存再放回项目。第二种是游戏内Label文字全部变成方块或者问号。这和编码无关是字体问题。Godot默认字体对中文支持有限需要设置中文字体。最简单的方案是把系统里的微软雅黑复制到项目fonts目录拖进编辑器然后在Project Settings - Gui - Theme - Custom Font里选择它。更灵活的做法是在代码里用SystemFont动态加载var font : SystemFont.new() font.font_names PackedStringArray([Microsoft YaHei, Noto Sans CJK SC, PingFang SC]) $Label.add_theme_font_override(font, font)这段代码让TextServer从系统里查找匹配的中文字体好处是不用把几十MB的字体文件打进包。5.2 $Block和get_node路径到底从谁开始数第二个高频报错是“Node not found”。很多人照着教程敲代码却忘了节点路径是相对当前脚本所在节点写的。比如脚本挂在根节点Node2D上你想拿子节点Block直接写$Block就对了如果你写成$Node2D/Block反而会报错因为对于当前脚本来说根节点就是自己路径不需要再包含自己。最稳妥的写法是用export把节点路径导出到Inspector然后拖拽赋值export var block_path: NodePath onready var block: Node2D get_node(block_path)这样即使场景结构重构了只要在Inspector里重新拖一次节点代码一行都不用改。5.3 res://路径和场景实例化第三个容易踩坑的地方是资源引用。刚入门的人习惯引用C:\Users\xxx\player.png这种绝对路径一旦换电脑、移动工程所有资源全部断开。Godot里所有工程内资源都使用res://开头的相对路径res://对应的就是项目根目录。在文件系统面板把图片拖到Sprite2D的Texture属性时Godot会自动生成res://路径所以尽量用拖拽而不是手敲。加载另一个场景也一样要用res://配合preloadconst BlockScene : preload(res://block.tscn) func _ready(): var block : BlockScene.instantiate() add_child(block)preload是引擎在加载期就提前加载资源适合在项目里固定引用的内容如果资源需要运行时根据条件决定再用load。这一步做完你已经能用代码动态往场景里放方块了距离一个最简单的“物理沙盒”只差一两步。这篇记录差不多就到这里。回头看看最值得记住的不是怎么显示一个方块而是三个概念引擎和项目的边界在哪里节点与场景怎么组织脚本的钩子函数什么时候被调用。我自己的体会是Godot入门最大的障碍不是功能不会用而是总想着一口气学会所有功能。官方文档、示例项目和别人的工程都可以当字典查遇到问题搜一搜比硬记快得多。最后再分享一个小技巧把C盘某个固定目录设为Godot项目根目录然后在项目管理器里把常用工程加进“Favorite”后面打开效率会高很多。下一篇文章大概率会做更靠近游戏的东西——想办法让方块落在地面上而不是穿过它继续往下掉。到时候那个方块就不会只是显示出来了。