HOME / 第 2 部分 · 核心概念与 GDScript 语法 / 第 10 课
MODULE 2 · 核心概念与 GDScript 语法

第 10 课 · GDScript 快速入门:第一个脚本

⏱ 预计时长 25 分钟📊 难度 入门📚 模块 第 2 部分 · 核心概念与 GDScript 语法

🎯 本课学习目标

从本课开始进入编程世界。GDScript 是 Godot 的专属语言,类似 Python,极其易读。我们先写第一个脚本。

📖 详细教学步骤

创建脚本实操

  1. 在场景面板选中根节点(如 Node2D)
  2. 点击检查器右上角的「脚本」按钮(文档图标)
  3. 选择「新建脚本」,命名为 main.gd,确认创建
  4. 编辑器自动打开脚本编辑器(顶部中间的「脚本」标签)

💡 也可以:选中节点 → 右键 → 附加脚本(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

运行并查看输出实操

  1. F5 运行游戏
  2. 看编辑器底部「输出(Output)」面板
  3. 能看到 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 是调试利器。