HOME / 第 2 部分 · 核心概念与 GDScript 语法 / 第 10 课
MODULE 2 · 核心概念与 GDScript 语法
第 10 课 · GDScript 快速入门:第一个脚本
🎯 本课学习目标
- 学会创建脚本并挂到节点上
- 理解 extends、_ready、_process 三个基础
- 会使用 print 输出调试信息
从本课开始进入编程世界。GDScript 是 Godot 的专属语言,类似 Python,极其易读。我们先写第一个脚本。
📖 详细教学步骤
创建脚本实操
- 在场景面板选中根节点(如 Node2D)
- 点击检查器右上角的「脚本」按钮(文档图标)
- 选择「新建脚本」,命名为
main.gd,确认创建 - 编辑器自动打开脚本编辑器(顶部中间的「脚本」标签)
💡 也可以:选中节点 → 右键 → 附加脚本(Attach Script)。
看懂脚本的基本结构概念
Godot 自动生成的脚本长这样:
GDSCRIPTextends Node2D # 本脚本所属的节点类型
# 当节点进入场景时执行一次(相当于开场)
func _ready():
pass # pass = 什么都不做,占位
三个最基础的函数概念
| 函数 | 何时执行 | 用途 |
|---|---|---|
| _ready() | 进入场景时执行 1 次 | 初始化:设置数值、连接信号 |
| _process(delta) | 每帧执行(约每秒60次) | 持续更新:移动、检测 |
| _physics_process(delta) | 每秒固定 60 次 | 物理相关移动(更稳定) |
💡 delta 是「本帧与上一帧的时间差」(秒),用于让移动速度与帧率无关。
写你的第一行代码:print实操
把脚本改成:
GDSCRIPTextends Node2D
func _ready():
print("Hello, Godot!") # 打印到底部输出面板
func _process(delta):
# 每帧打印一次(会刷屏,先注释掉测试)
# print("每帧执行, delta =", delta)
pass
运行并查看输出实操
- 按
F5运行游戏 - 看编辑器底部「输出(Output)」面板
- 能看到
Hello, Godot!被打印出来
🎉 你正式用 GDScript 写代码并成功运行了!
⚠️
脚本图标显示警告(黄色感叹号)?
表示脚本有潜在问题。打开脚本编辑器看底部「错误/警告」标签,按要求修复(比如函数没用到可以删除)。
⚠️
print 里的中文乱码?
确保脚本文件以 UTF-8 保存(Godot 默认就是),一般不会乱码。
⚠️
_process 里 print 每帧刷屏怎么办?
调试完记得注释或删掉,否则输出面板会被刷爆。
🧪 动手试一试
🏋️ 课后练习
新建脚本 main.gd,在 _ready 里 print 你的名字和今天日期,在 _process 里用代码注释掉的那行 print,运行观察输出。
print("名字");每帧输出用 print(delta)。
💡
print 是调试神器:出 bug 时在关键位置 print 变量值,立刻知道哪里不对。
💡
脚本文件用 .gd 后缀,一个节点可以挂多个脚本(一般只挂一个)。
🎓 本课小结
GDScript 类似 Python。核心三函数:_ready 初始化、_process 每帧更新、_physics_process 物理帧更新;print 是调试利器。