学习空间/第一次打开编辑器:从空项目到 F6 与 F5
上手工作坊 / LESSON 53

第一次打开编辑器:从空项目到 F6 与 F5

不下载素材、不先装插件,用一行文字建立你的第一个可运行场景。

零基础约 7 分钟阅读,实作另计6 节现在学
CONCEPT MAP先看一眼知识之间的联系
先看一眼知识之间的联系01F6:当前场景02F5:项目主场景03保存:留下修改04输出:查看脚本反馈
先把编辑、保存和运行入口分开理解。

01先准备一张不会碰坏正式项目的练习桌

本课目标不是做出恐怖气氛,而是亲自走通“创建、保存、运行、修改、再次运行”。先关闭正式游戏的编辑器窗口,在项目管理器中新建名为 FirstRoomLab 的练习项目,放到你自己选定的空目录,不要选择正式游戏目录,也不要把正式工程复制过来当起点。渲染器选择 Compatibility,语言沿用标准版支持的 GDScript。

打开“帮助 → 关于”,记录本机显示的引擎版本;课程按 Godot 4.7 官方文档说明关键行为,项目背景中的版本记录不是本次实测。如果创建界面出现版本管理选项,不必为了这一课配置远程仓库,先保留项目默认生成的忽略文件。

02第一步:认清你正在选中什么

进入编辑器后先找三个地方:左侧场景树列出当前场景中的节点;左下文件系统列出磁盘资源;右侧检查器显示当前选中对象的属性。它们不是同一份列表。点击文件是在选择资源,点击节点是在选择场景里的对象,属性跟着选择变化。

在空场景中点击“其他节点”,搜索并创建 Node,改名为 FirstRoom。选中它,再添加一个 Label 子节点,改名为 Welcome。最终结构应是 FirstRoom (Node) → Welcome (Label)。若两者同级,先把 Welcome 拖到 FirstRoom 上成为子节点;不要靠重建整个工程修正一次误点。

03第二步:让一句话出现在运行窗口

选中 Welcome,在检查器的 Text 中输入“练习房已打开”。切换到 2D 工作区,把文字移动到可见画布左上方略靠内的位置,例如横纵各约 40 像素。不要放到负坐标区域;也不需要先理解所有锚点。按 Ctrl + S,把场景保存成 res://first_room.tscn。这里的 res:// 指本练习项目根目录,不是某个固定磁盘。

点击右上角“运行当前场景”,默认快捷键是 F6。看到这句话就是第一个成功结果。停止运行后,把文本改为“第二次运行”,保存,再运行,确认自己确实看到了新文字。这个小循环比背诵面板名称更重要。

04第三步:用两个场景分清 F6 和 F5

新建第二个场景,仍用 Node 加 Label,文字写“这是备用房”,保存为 res://spare_room.tscn。打开备用房按 F6,应看到备用房;按 F5,若尚未设置主场景,就在提示中选择 first_room.tscn。之后即使正在编辑备用房,F5 仍从主场景开始。

F6 是试当前打开的场景,F5 是从项目入口启动。 两种运行结果不同不一定是代码有错,可能只是入口不同。也不要把场景文件名、场景根节点名、项目名混为一谈:它们可以不同,各自解决不同问题。快捷键被系统占用时,直接使用工具栏按钮完成同一操作。

05第四步:让脚本说一句话,并看懂反馈位置

回到 FirstRoom,选中根节点并附加 GDScript,脚本基类应为 Node,关闭模板或清空模板后输入下面的完整示例。运行后在底部“输出”面板中找这句话;它不会自动显示到游戏画面。画面的 Label 与调试输出承担不同职责。

extends Node

func _ready() -> void:
    print("FirstRoom 已准备好")

本示例已依据官方语法核对,未在本机 Godot 引擎运行。若出现红色报错,先看第一条错误及其行号:中文引号、缺少冒号、缩进不齐,都是可逐项修正的小问题。不要立即让 AI 生成一个更复杂的启动管理器。

06排错与验收:证明不是恰好跑起来

看不到文字时依次检查:运行的是哪个场景;Label 的 Text 是否为空;节点是否隐藏;位置是否落在窗口内;文本颜色与背景是否太接近。脚本没有输出时,检查是否挂在正在运行场景的根节点上。每次只改一个原因再试,避免同时改五个属性后不知道哪一个有效。

验收练习:关闭编辑器,重新从项目管理器打开练习项目;分别演示 F6 打开备用房、F5 打开主房;修改一次 Label 文本并说明它保存在哪个资源文件。最后写下“我改了什么、预期什么、实际什么”三句话。能独立重做这一步,才算建立了后续学习的起点。

动手后,再勾选

不是“我看懂了”,而是你在独立练习里做出并检查过。

CHECK YOUR UNDERSTANDING

换一个情景,你会怎么判断?

你正在编辑备用房,但 F5 总是打开第一间房,最先检查什么?

用自己的话,留一条笔记

可以写“我之前以为……,现在发现……”,或者记录还没解决的问题。

仅保存在此浏览器0 / 20000

回到资料核对

本课是解释与练习,不替代对应版本的官方手册。网页实验不运行 Godot;未标明实机验证的代码,仍需在独立工程中检查。

把这课收进你的理解里。

标记已读不会自动勾选实作,也不代表游戏功能已经完成。

输入一个你想弄明白的问题。

按 Esc 关闭 · 标题、关键词和正文一起搜索