教程一 · 第 1 章：开篇与环境搭建#

系列目录#

教程一：Godot C# 从零开始（9 篇）

1. 开篇与环境搭建（本文）
2. 节点、场景与脚本
3. 第一个完整游戏：Pong
4. 2D 平台跳跃
5. 信号与节点通信
6. Resource 数据驱动、实例化与存档
7. UI 与游戏流程
8. 音效、粒子、屏幕震动与调试
9. 导出发布与学习路线图

教程二：为 Godot 学 C#（7 篇）

10. 变量与类型
11. 运算符、流程控制与方法
12. 数组、字符串、空值与异常
13. 类与对象
14. 继承、多态与接口
15. 集合、泛型、委托、LINQ 与异步
16. GDScript 到 C# API 对照速查表

版本说明（2026 年 10 月）：基于 Godot 4.7.x .NET 版，最低需要 .NET SDK 8。下载时认准名字带 ”.NET” 的 Godot；中文路径和中文脚本名容易触发工具链怪问题，项目路径尽量全英文。

1.1 Godot 是什么#

Godot 是一款开源、免费、MIT 协议的游戏引擎，2014 年开源，由社区和 Godot 基金会维护。你可以把它理解成”游戏界的 Blender”：不收分成、不抽成、不强制登录账号，做出来的游戏 100% 是你自己的，导出到 Windows / macOS / Linux / Android / iOS / Web 都行。

它和你可能听过的引擎对比：

2023 年之后 Godot 4 成熟度飞跃，4.5/4.6/4.7 几个版本把 C# 的 Web 导出、.NET 新版本支持、3D 渲染都补齐了，现在是独立开发者用 C# 做游戏性价比最高的选择之一。

1.2 为什么用 C# 而不是 GDScript#

Godot 自家语言 GDScript 类似 Python，入门极快；C# 是微软做的静态类型语言，也是 Unity 的主力语言。怎么选？

选 C# 的理由：

• 你已经在用或想学一门”走出游戏圈也值钱”的语言——C# 在后端、桌面、Web、Unity 生态里都是硬通货
• 静态类型：编译期就能抓出一大类错误，项目越大越香
• 性能：复杂逻辑（大量单位、寻路、数据处理）明显快于 GDScript
• .NET 生态：Json、HTTP、数学库、单元测试……NuGet 上几万个包直接用
• 你的编程经验（C/C++/Java/TS）能平滑迁移

GDScript 更适合的场景：做个 Game Jam 小品、完全零基础只想快速看到效果、教程几乎全是 GDScript 时不介意语言切换。

一个 Godot 项目里 C# 和 GDScript 可以混用，但新手不建议，先一门深入。本教程全程 C#。

1.3 需要安装的三样东西#

1
dotnet --info

1.4 创建第一个 C# 项目#

1. 启动 Godot，项目管理器点 新建项目
2. 项目路径选一个全英文路径，例如 D:\GameDev\MyFirstGame
3. 渲染器选 Forward+
4. ⚠️ 关键：点”创建”之后，顶部菜单 项目 → 工具 → C# → 创建 C# 解决方案（新版 Godot 也可能在新建项目时直接给 ”.NET/C#” 项目模板选项，有就直接选）。创建成功后项目文件夹里会多出：
   • MyFirstGame.csproj —— C# 工程文件
   • MyFirstGame.sln —— 解决方案（用 VS Code/VS 打开它）
5. 菜单 项目 → 工具 → C# → Build（构建），底部面板显示 Build succeeded，环境全通

如果没有”创建 C# 解决方案”菜单，说明你下的是不带 .NET 的普通版，回去重下。

1.5 认识编辑器界面#

打开项目后，主界面是这样的：

1
┌──────────────────────────────────────────────┐
2
│  顶部菜单 / 播放按钮 ▶                          │
3
├────────┬───────────────────────┬─────────────┤
4
│ 场景    │                       │  检查器      │
5
│ Scene  │      2D/3D 视口        │  Inspector  │
6
│ 面板    │      （编辑画面）       │ （选中物的    │
7
│        │                       │  所有属性）   │
8
├────────┤                       ├─────────────┤
9
│ 文件系统│                       │  节点        │
10
│FileSystem                      │  Node       │
11
├────────┴───────────────────────┴─────────────┤
12
│  底部：输出 / 调试器 / 查找结果                  │
13
└──────────────────────────────────────────────┘

• FileSystem（文件系统）：项目里所有资源、脚本、图片
• Scene（场景）：当前场景的节点树
• Inspector（检查器）：选中节点后，它的位置、颜色、脚本变量都在这里改
• 视口：所见即所得的编辑区
• 底部输出面板：GD.Print 的文字会出现在这里，C# 编译报错也在这里

右上角三个按钮：

• ▶ 运行项目（F5）
• ⏸ 但更常用的是 F6：运行当前场景（不用每次从主场景启动）

1.6 第一个脚本：让节点开口说话#

目标：创建一个节点，挂上 C# 脚本，运行时在输出面板打印一句话。

1. 场景面板点 ”+” 或 “其他节点”，搜索 Node（最基础的节点类型），添加
2. 场景面板里右键这个 Node → 重命名为 Main
3. Ctrl+S 保存场景，命名为 main.tscn，存到 scenes/ 文件夹（保存时在弹窗里新建文件夹）
4. 菜单 项目 → 项目设置 → 应用 → 运行 → 主场景，选 main.tscn（这样 F5 从这里启动）
5. 选中 Main 节点，点击检查器顶部的 卷轴图标（附加脚本）：
   • 语言选 C#
   • 类名保持 Main，路径 res://Main.cs（或建个 scripts/ 文件夹放进去）
   • ⚠️ 类名必须和文件名完全一致
6. 生成的代码长这样：

1
using Godot;
2

3
public partial class Main : Node
4
{
5
    public override void _Ready()
6
    {
7
        GD.Print("游戏启动了！");
8
    }
9
}

7. 在 _Ready 里补上一行：

1
GD.Print("你好，Godot C#！");

8. 点右下角/底部的 Build（构建） 按钮，等 Build succeeded
9. 按 F5

底部输出面板出现：

1
游戏启动了！
2
你好，Godot C#！

恭喜，环境链路全部跑通：Godot → MSBuild 编译 C# → 引擎加载程序集 → 调用 _Ready → 打印。

1
using Godot;          // 引入 Godot 的 API 命名空间，GD、Node 都在这里
2
public partial class Main : Node   // 声明一个类 Main，它"是"一个 Node
3
{
4
    public override void _Ready() // 重写引擎回调：节点进入场景时执行一次
5
    {
6
        GD.Print("...");          // 相当于 GDScript 的 print / 控制台输出
7
    }
8
}

1.7 新手最常见的五个报错#

1.8 本章作业#

1. 把打印内容改成当前日期，并用字符串拼接输出，例如 今天是 2026-10-14（提示：先写死字符串就行，别查 API）。
2. 再建一个 Node2D 场景，挂脚本打印 "这是 2D 场景"，用 F6 单独运行它。
3. 把 Godot 编辑器语言改成中文（编辑器 → 编辑器设置 → 通用 → 语言）再切回英文——专业教程和报错信息几乎都是英文，建议用英文界面，把它当学习的一部分。

下一章我们进入 Godot 最核心的心智模型：节点和场景，这是理解整个引擎的钥匙。

《Godot C# 零基础》系列导航

📑 返回系列总目录（第 01 篇） ➡️ 下一篇：Godot C# 零基础教程 02：节点、场景与脚本