第1章 从零开始:破除迷茫,建立认知
「合抱之木,生于毫末;九层之台,起于累土。」——《道德经》
欢迎来到《酒魂》的开发之旅,也欢迎你正式踏入游戏开发的世界。
在你打开 Godot 引擎之前,我想先和你聊几件比技术更重要的事——心态。很多人在学习游戏开发的过程中,不是被技术难倒的,而是被自己头脑中错误的预设打倒的:「我不会数学」「我没学过编程」「一个人做不了游戏」。
本章要解决什么问题: 把这些错误预设一一拆解,还原游戏开发的真实面目,帮你找到属于自己的起点,完成从「游戏玩家」到「游戏开发者」的心态转变。最后通过实操搭建好开发环境,完成你的第一个《酒魂》项目。
这一章没有一行真正的游戏代码,但它是全书最不能跳过的一章——因为它决定了你能走多远。
1.1 游戏开发到底难不难?——拆解恐惧,理性认知
如果你问一个做了五年游戏的老手「游戏开发难不难」,他可能会耸耸肩说:「就那样。」
如果你问一个刚入行三个月的新手,他可能一脸茫然:「太难了,不知道从哪下手。」
为什么同样的领域,感受相差这么大?因为他们面对的根本不是同一个问题——老手已经把「大问题」分解成了无数个可以独立解决的「小问题」;新手面对的是一个没有被拆解的整体,自然感觉无从下手。
1.1.1 「太难了」通常意味着什么
当你感到「游戏开发太难了」,这种感觉背后通常是以下几种情况之一,而不是你不够聪明:
| 你的感受 | 真正的原因 |
|---|---|
| 「概念太多,脑子乱」 | 信息量过载——一次性接触了太多概念(节点、信号、资源、脚本……),大脑还没把它们分类归档 |
| 「写了一堆代码,屏幕上什么都没发生」 | 缺少反馈——不知道自己写得对不对,找不到前进的方向 |
| 「想做个游戏,但不知道第一步干什么」 | 目标不清晰——「游戏」这两个字太模糊,陷入内耗 |
| 「看看 3A 大作,再看看我的代码」 | 错误比较——拿别人的成品和自己的起点比,落差极大,容易自我否定 |
关键认知:游戏开发的「难」,绝大多数是认知结构问题,不是智力问题。 你不是不够聪明,你只是还没有找到正确的拆解方式。本书的核心任务之一,就是帮你建立这套拆解结构,让复杂的开发过程变得有章可循。
1.1.2 独立游戏的真实工作量
网上流传着很多关于独立游戏开发的「神话」——一个人做了五年,做出了《星露谷物语》;一个团队三个月做出了爆款。这些故事是真实的,但它们不是典型情况,而是极端案例(幸存者偏差)。
以《酒魂》这样规模的单机游戏为例,一个有一定基础的独立开发者(不是完全零基础)完成一个「够玩」的版本,大约需要以下时间:
| 阶段 | 参考时间(业余 / 全职) |
|---|---|
| 学习 Godot 基础,到能独立写功能 | 4-8 周 / 2-3 周 |
| 完成核心玩法原型(酿造 + 基础战斗) | 2-3 个月 / 1-1.5 个月 |
| 扩展内容(任务、AI、存档) | 3-4 个月 / 2 个月 |
| 打磨、测试与发布准备 | 1-2 个月 / 3-4 周 |
| 总计(写实估算) | 约 10-18 个月(业余)/ 约 4-6 个月(全职) |
这个数字是为了让你有心理准备,而不是为了吓退你。游戏开发是一场马拉松,节奏比速度更重要。 很多人在前三个月做出了很好的原型,然后因为「感觉做不完」而放弃——其实他们距离终点已经走过了最难的那段路。
1.1.3 三个最常见的认知误区
新手入门时最容易陷入以下三个误区,提前认清它们,能帮你少走很多弯路。
误区一:「我要先把数学学好再做游戏」
真实情况:《酒魂》这类 2D 游戏,绝大多数功能用到的数学只有加减乘除和偶尔的三角函数。你在初中学过的数学已经完全够用了。本书所有涉及数学的部分,都会用直白的语言解释「为什么这么算」,而不只是给你一个公式——让你知其然,更知其所以然。
误区二:「没有美术基础就做不了游戏」
真实情况:在学习阶段,完全可以使用免费的占位图片(placeholder)、开源素材和程序化生成的图形。本书配套资源已经包含《酒魂》用到的全部美术资产,你不需要自己画一笔。 等你把系统做通了,再考虑打磨美术细节也不迟。
误区三:「一个人做游戏太孤独、太难坚持」
真实情况:孤独是真的,但有解法——游戏开发社区、打卡群、Game Jam(游戏创作马拉松)都是很好的外部驱动力。2.4 节会专门介绍如何利用社区让自己坚持下去,找到同路人。
小结:游戏开发难不难,取决于你怎么拆解。 本书的结构就是一套经过验证的拆解方式:从最小的可运行程序开始,一层一层向上搭建,每一步都有看得见的成果,让你在成就感中逐步前进。
1.2 你需要什么基础?——诚实自测,明确短板
很多新手会纠结「我没有基础,能学吗?」答案是:完全可以。
游戏开发没有绝对的「基础门槛」,但具备一些基础能力能让学习更轻松。下面是一份诚实的自测清单,帮你认清自己的起点(无需全部达标,仅供参考)。
1.2.1 必备基础(没有这些会很艰难)
| 条件 | 说明 |
|---|---|
| 能流畅操作电脑 | 会创建文件夹、安装软件、用浏览器搜索。这是所有电脑相关学习的基础 |
| 能静下心来读中文技术文档 | 本书内容清晰易懂,但需要你愿意多读几遍,理解核心逻辑 |
| 对游戏有真实的热情 | 不需要是硬核玩家,但你要真的想做出一款自己满意的游戏——这份热情会成为你克服困难的核心动力 |
1.2.2 加分基础(没有也没关系,后续可补充)
| 加分项 | 如果有,你可以…… |
|---|---|
| 有任意语言的编程基础 | 更快理解 GDScript 语法,把精力集中在「游戏逻辑」而不是「语法」上 |
| 玩过 RPG / 经营类游戏 | 对《酒魂》的系统设计(酿造、战斗、任务)有更深的直觉理解 |
| 有基础美术或音乐能力 | 在项目打磨阶段,可以做出更有个人风格的内容 |
| 接触过 Unity 或 UE 等引擎 | Godot 的概念虽有不同,但你已经有了引擎学习的思维,学习曲线会更平缓 |
1.2.3 你不需要的东西
放心清单: 以下这些你完全不需要,不用为没有这些而焦虑。
✗ 数学专业背景(初中数学足够)
✗ 计算机科学学位
✗ 绘画或设计能力(有配套美术资产)
✗ 英语阅读能力(本书全中文,Godot 有官方中文文档)
✗ 昂贵的硬件(Godot 对配置要求极低,4GB 内存的电脑完全够用)
自测之后,无论你当前基础如何,都无需焦虑。本书的内容设计就是「从零开始」,会根据新手的学习节奏逐步讲解所需的所有知识。
1.3 学习路径规划——三条路线,对号入座
游戏开发的学习最忌讳「盲目跟风」——看到别人学 Unity 就跟着学,看到别人学 3D 建模就转而学建模,最后什么都学不精。
结合本书的核心内容(Godot 4.7 + 《酒魂》项目),我们根据不同基础为你制定了三条阅读路径。找到自己所在的那条,按图索骥即可。
先说清楚本书的结构,三条路径都建立在这个结构之上:
部分 章节 内容 第一部分 第 1-3 章 认知、方法论、设计蓝图 第二部分 第 4-8 章 项目骨架、数据驱动、主角、地图、投壶原型 第三部分 第 9-10 章 UI 基础、背包 第四部分 第 11-14 章 战斗系统(敌人、醉意、大招、战斗 UI) 第五部分 第 15-17 章 酿造系统 第六部分 第 18-20 章 剧情与人际 第七部分 第 21-24 章 酒坊经营与闭环验证 第八部分 第 25-27 章 优化与发布 你不需要记这张表。 记住一件事就够了:第 7 章你会做出第一个能玩的《酒魂》。
1.3.1 三条专属学习路径
路径 A:完全零基础
建议顺序:第 1-3 章(全读)→ 第 4-8 章(按顺序推进,动手跟着做)→ 之后按章节顺序读完。
重点:不要跳过任何一章的动手环节。 每章的代码都务必在 Godot 里实际运行一遍,避免「眼会手不会」。
路径 B:有编程基础,不了解 Godot
建议顺序:第 1-2 章快速浏览(其中 1.5 节请动手装好环境)→ 第 3 章(读设计蓝图,搞清《酒魂》要做什么)→ 第 4-8 章(重点理解节点与信号机制)→ 之后按章节顺序正常推进。
重点:GDScript 的信号(signal)机制与你熟悉的事件系统思路不同,相关小节要认真研读,避免套用原有编程思维。
路径 C:有 Unity / UE 等引擎经验
建议顺序:第 2-3 章快速浏览(其中 1.5 节请动手装好环境)→ 第 4-8 章(对照阅读,重点理解节点机制)→ 之后按章节顺序正常推进。
重点:Godot 的「一切皆节点」哲学与 Unity 的 GameObject / Component 架构有本质区别。避免直接套用 Unity 思维,重点理解节点与信号的核心逻辑。
1.3.2 新手避坑指南(通用建议)
无论哪条路径,都请记住以下四条建议:
- 亲手跑每一段代码。 读书和动手是两种截然不同的学习效果。把代码真正运行起来之后,再回头看理论章节,清晰度会翻倍。
- 不急于求成。 不要想着「一周学会游戏开发」。每天投入 1-2 小时稳步推进,比「突击学习」更有效,也更容易坚持。
- 不怕 Bug。 Bug 是开发者的常态,哪怕是资深开发者也会遇到各种报错。遇到 Bug 时不要慌,按照 2.3 节的「调试五步法」逐步排查——每解决一个 Bug,你的能力就提升一步。
- 不盲目扩展。 不要因为看到其他有趣的技术就偏离本书路径。先完成《酒魂》,再去拓展其他领域(比如 3D 开发、音效制作)。
请记住:最适合自己的学习路径,就是「循序渐进、注重实操」的路径。
1.4 为什么选择 Godot?——引擎无关视角,聚焦核心能力
目前市面上有很多游戏引擎:Unity、Unreal Engine(虚幻引擎)、Cocos 等。为什么本书选择 Godot 作为教学载体?
不是因为 Godot「比其他引擎更好」,而是因为它更适合新手,更能帮助我们聚焦「游戏开发的核心能力」。
所谓「引擎无关」的视角,意思是:先把眼光放在游戏开发本身,而不是绑死在某一款软件上。无论使用哪款引擎,游戏开发的核心逻辑都是相通的——都是「通过代码控制游戏元素,实现玩法规则,给玩家带来良好体验」。选择 Godot,只是为了让新手更容易上手,更快地把精力投入到玩法设计和逻辑实现上,而不是被引擎的复杂操作困扰。
Godot 适合新手的核心优势:
| 优势 | 说明 |
|---|---|
| 完全免费开源 | 没有版权费用,无需订阅,个人学习或商业开发都可自由使用,不用担心版权问题 |
| 上手门槛低 | 自带 GDScript,语法简洁易懂,接近 Python;引擎界面简洁,核心功能清晰,不需要复杂配置就能开始 |
| 轻量高效 | 安装包不到 100MB,运行流畅,配置普通的电脑(4GB 内存即可)也能跑得很顺,不会出现「电脑带不动」 |
| 功能足够 | 支持 2D 和 3D,自带丰富的节点、动画、物理系统,足以满足独立游戏开发的所有需求 |
| 社区友好 | 有大量中文教程、开源项目和社区支持(官方中文文档、B站教程等),遇到问题能快速找到答案 |
再次强调:本书的核心是「教你如何开发游戏」,而不是「教你如何使用 Godot」。 Godot 只是我们的工具。通过这个工具,你会掌握游戏开发的核心逻辑和思维——未来无论切换到哪款引擎,都能快速适应。
1.5 工具箱安装(Godot 4.7 + Git + Gitee)
「工欲善其事,必先利其器。」在开始开发之前,我们需要安装三款核心工具,它们将伴随整个《酒魂》项目的开发过程:
- Godot 4.7——游戏开发引擎,我们的主战场
- Git——版本控制工具,让你随时可以「反悔」
- Gitee——国内的代码托管平台,相当于线上的代码仓库
本小节提供详细的安装步骤,全程新手友好,每一步都标注了注意事项和常见问题。
1.5.1 安装 Godot 4.7
Godot 完全免费、开源,不需要管理员权限,安装过程非常简单。
-
下载安装包。 访问 Godot 官方下载页(https://godotengine.org/download),选择你的操作系统(Windows / macOS / Linux),下载 Standard 版本。
注意: 不要选 .NET 版本,除非你打算用 C# 开发。我们用的是 GDScript。
-
安装步骤(按系统选择):
- Windows: 下载的是一个 .zip 压缩包,解压后直接双击
Godot_v4.7-stable_win64.exe即可运行,无需安装。建议放在固定目录(如D:\Godot),方便后续查找。 - macOS: 下载 .dmg 文件,拖入「应用程序」文件夹。首次打开需要在「系统设置 → 隐私与安全性」中点击「仍要打开」。
- Linux: 下载
.x86_64文件,chmod +x后即可运行。
- Windows: 下载的是一个 .zip 压缩包,解压后直接双击
-
验证安装。 打开 Godot,若能正常进入项目管理器界面(显示「新建项目」「导入」等选项),说明安装成功。
常见问题: Windows 上双击无反应?右键选择「以管理员身份运行」试试。如果提示缺少 DLL,通常是缺少 VC++ 运行库,在微软官网搜索「Visual C++ Redistributable」下载安装即可。
1.5.2 安装 Git 并配置 Gitee
Git 的核心价值是:任何时候都可以「反悔」——回到过去的任意项目状态,避免因误操作丢失代码。Gitee 则相当于线上的代码仓库,可以把本地代码上传备份。
-
下载安装 Git。 访问 https://git-scm.com/download,选择对应系统版本下载并安装,全程点击「下一步」即可(默认配置已满足我们的需求)。
-
验证安装。 按
Win键,输入「Git Bash」,回车——打开的这个黑底白字窗口就是终端,本书后面说的「打开终端」「执行命令」都指在这里输入。输入:git --version按回车。若能显示版本号(如
git version 2.52.0.windows.1),说明安装成功。如果提示「'git' 不是内部或外部命令」,说明安装时环境变量没配上——最省事的解法是卸载后重装,安装时在「Adjusting your PATH environment」一步选择「Git from the command line and also from 3rd-party software」(默认第二项就是它)。

-
注册 Gitee 账号。 访问 https://gitee.com,点击右上角「注册」,输入手机号、验证码,设置用户名和密码,完成注册。建议用户名简单易记,后续会用于关联 Git。
-
配置 Git 身份与 Gitee 关联。 打开终端(Windows 用 Git Bash,macOS / Linux 用自带终端),执行以下命令(只需执行一次):
git config --global user.name "你的Gitee用户名" git config --global user.email "你的Gitee注册邮箱"小技巧: Windows 上想快速在某个文件夹打开 Git Bash,只需在该文件夹空白处单击右键,选择「Open Git Bash here」即可。
-
现在就试一把:在本地完成你的第一次 commit(不需要网络、不需要 Gitee)。 配置做完不代表能用,我们花两分钟真刀真枪跑一遍(这一次真的可以执行):
- 在任意位置新建一个文件夹,比如
D:\git-test,右键它 →「Open Git Bash here」; - 依次执行(
#后面是注释,不用输):
git init # 把这个文件夹变成 Git 仓库 echo "hello jiuhun" > test.txt # 随便造一个文件 git add . # 把改动放进暂存区 git commit -m "我的第一次提交" # 提交——成功!- 看到输出形如
1 file changed的绿色结果,恭喜——你已经完成了一次真实的版本存档。这个D:\git-test文件夹练完可以整个删掉。
你可能会问:「还没连 Gitee 也能 commit?」能。
commit只是存档到本地,完全不联网;「上传到 Gitee」是第三步push的事,那要等第 4 章建好你自己的远程仓库。Git 的三步是一层比一层远的:暂存区(购物车)→ 本地仓库(你家)→ 远程仓库(云盘)。 - 在任意位置新建一个文件夹,比如
1.5.3 日常开发的 Git 三步循环
配置完成后,你日常的代码备份流程就是这三条命令:
git add . # 1. 把改动加入暂存区
git commit -m "完成背包拖拽功能" # 2. 提交到本地仓库,说明做了什么
git push origin master # 3. 推送到 Gitee 远程仓库
如果团队协作,建议先 git pull 拉取最新远程变更,再执行上述步骤。
现在先不用真的执行这三条命令。 你还没有属于自己的远程仓库——1.6 节创建的项目也还没做 Git 初始化,直接
push会报错。这套流程会在第 4 章 4.1.3 一步步带你跑通,包括建远程仓库、生成推送用的「私人令牌」。现在只需记住这个节奏:改代码 → 三步保存 → 任何时候都能反悔。
养成一个好习惯:每完成一个功能,就执行一次 commit。 提交信息写清楚做了什么,例如「完成背包拖拽功能」。三个月后你会感谢现在的自己——它救过无数人的代码。
注意事项:
- 安装 Git 时若出现「是否将 Git 添加到环境变量」的选项,一定要勾选,否则后续无法在终端中使用 Git 命令。
git config里的用户名和邮箱是提交记录上的署名(相当于快递单上的寄件人),写成什么都不影响你能不能上传代码——建议填 Gitee 的注册信息,只是为了让署名和账号对得上而已。真正决定「能不能推送」的是身份验证:Gitee 推送用的是私人令牌(不是登录密码),生成方法在第 4 章 4.1.3 首次推送前带你操作。
1.5.4 安装问题速查表
| 症状 | 解决方法 |
|---|---|
| Godot 打开是英文界面 | 编辑器 → Editor Settings → Interface → Editor Language → 简体中文 |
| 运行项目时窗口闪一下就消失 | 查看底部「输出」面板的红色报错信息,通常是脚本语法错误 |
'git' 不是内部或外部命令 |
环境变量没配好——重装 Git,PATH 一步选「Git from the command line and also from 3rd-party software」(见 1.5.2 步骤 2) |
Git commit 报错 user not set |
重新执行 git config 命令,正确设置用户名和邮箱 |
| Git Bash 里中文显示为乱码或方块 | 窗口标题栏右键 → Options → Text → Character set 选 UTF-8,字体换成中文(如「新宋体」) |
| macOS 上 Godot 无法打开 | 系统设置 → 隐私与安全性 → 点击「仍要打开」 |
1.6 验证安装:第一个「Hello, 酒魂」
安装完所有工具后,我们来创建第一个项目,验证工具是否能正常使用,同时感受一下游戏开发的乐趣。
这个项目非常简单,只是在屏幕上显示「Hello, 酒魂!」几个字,但它能帮你熟悉 Godot 的基本操作,完成从「零」到「一」的突破。
1.6.1 创建新项目
- 打开 Godot 引擎,在项目管理器界面点击「新建项目」(New Project)。
- 在弹出的窗口中:
- 项目名称:填
WineSoul(也可以用中文名,方便查找) - 项目路径:选择一个固定位置,例如
D:\Godot\Projects\WineSoul - 渲染器:选「兼容」(Compatibility)。这个选项对配置要求最低,我们的 2D 像素游戏完全够用。
- 项目名称:填
- 点击「创建并编辑」,进入 Godot 编辑器(首次进入可能有短暂加载,耐心等待即可)。

1.6.2 创建场景与节点
-
在场景面板中,点击「+」号,选择「Control」(控制节点)作为根节点,命名为
Main。为什么用 Control 而不是 Node2D? 因为这个项目只显示文字,不涉及游戏世界。Control 节点是用来做界面的,它自带「居中」的能力,后面做 UI 时会经常用到。现在只需要记住:根节点是场景的核心,所有其他节点都要挂在它下面。
-
选中
Main节点,再次点击「+」号,选择「Label」(文本节点),命名为HelloLabel。
1.6.3 设置文本内容与样式
-
选中
HelloLabel节点,在右侧的「检查器」(Inspector)面板中,找到「Text」属性,输入:Hello, 酒魂! -
调整字体大小。 在检查器中展开「Theme Overrides」(主题覆盖)→「Font Sizes」(字体大小),勾选并填入
32。 -
调整位置。 有两种做法,任选其一:
- 鼠标拖动:在场景编辑器中直接把文字拖到屏幕中央。
- 精确设置:在检查器的「Layout」→「Transform」中,设置
Position的 X 和 Y 值。
新手建议先用拖动。 后面学到「锚点」时,你会知道让控件自动居中还有更聪明的办法——现在不必纠结。

1.6.4 运行项目,验证成果
- 按
Ctrl + S保存场景。若提示保存路径,命名为main.tscn即可。 - 点击右上角的「运行项目」按钮(▶ 图标),或直接按
F5。 - 首次运行会提示「选择主场景」,选择
main.tscn确认即可。 - 若能正常弹出窗口,窗口中央显示「Hello, 酒魂!」,说明 Godot 安装成功,你也成功创建了第一个项目。
如果你想让这个项目更「像样」一点(可选):在项目根目录新建
fonts文件夹,放入一个像素字体文件,然后在 Label 的 Theme Overrides → Font 中加载它。本书配套资源包里提供了《酒魂》全项目使用的像素字体,你可以直接拿来用。
恭喜你! 虽然这个项目非常简单,但它是你游戏开发之路的第一个里程碑。通过它,你已经熟悉了 Godot 最核心的几个操作——创建项目、创建场景、添加节点、设置属性、运行项目。这五步将贯穿我们后续所有的开发过程。
1.7 《酒魂》的素材准备清单
到这里,你的开发环境已经就绪。在进入下一章之前,还有一件事值得提前了解:《酒魂》需要哪些素材?它们从哪来?版权安全吗?
这一节不是让你现在就去找素材,而是给你一份清单——知道全貌,后面用到的时候就不会慌。
1.7.1 《酒魂》的素材构成
《酒魂》是一款2D 国风像素游戏,它的素材分为五类:
| 类别 | 具体内容 | 在《酒魂》里的例子 |
|---|---|---|
| 瓦片(Tile) | 用来拼地图的方块图案 | 草地、江水、青石板路、白墙、瓦顶、酒旗、古井 |
| 帧动画(Sprite Sheet) | 会动的角色图片,一张图切成多帧播放 | 主角的待机/行走/攻击/射箭;NPC 李白、杜甫;敌人醉鬼、酒虫 |
| 字体 | 游戏内显示文字用的字库 | 像素中文字体(用于对话、UI、伤害数字) |
| 音效 | 短的、动作触发的声音 | 挥刀声、酒坛碎裂声、脚步、按钮点击 |
| BGM | 长时间循环的背景音乐 | 江南小镇的悠扬民乐、战斗时的紧张鼓点 |
1.7.2 三种素材来源
① 使用配套资源包(本书读者的首选)
本书配套资源已经包含《酒魂》全流程所需的美术资产——瓦片集、角色帧动画、道具图标、UI 套件一应俱全,规格统一(32×32 瓦片 / 128×128 角色单帧 / 15 色统一色板 / 最近邻过滤)。你不需要自己画一笔,直接拿来用即可。
资源包的完整目录结构与每项素材的用途,见附录 B《酒魂》素材清单与版权。
② 使用免费开源素材
如果本书素材不够用,或你想做一些自己的东西,推荐几个安全的来源:
| 网站 | 内容 | 授权 |
|---|---|---|
| OpenGameArt.org | 海量 2D 素材,像素风尤其丰富 | 多为 CC0 / CC-BY |
| itch.io(免费素材区) | 独立开发者分享的素材包 | 逐个确认,多为 CC0 |
| Kenney.nl | 统一风格的 2D/3D 素材包 | 全部 CC0,个人商用均可 |
| Freesound.org | 音效素材 | 多为 CC0 / CC-BY |
③ 自己制作
后期如果你想让《酒魂》更有个人风格,可以用 Aseprite(像素画专用,付费)或 LibreSprite(免费开源)自己画。但这应该是项目后期的加分项,不是现在要考虑的事。
1.7.3 版权速查:三条不能踩的红线
这是很多新手吃过大亏的地方,请务必记住:
红线一:网上下载的图,不等于能用。 百度图片、Pinterest、各种素材站搜到的图,绝大多数有版权。用于自己的游戏(哪怕是免费的)也可能构成侵权。
红线二:CC0 ≠ 可以用一切。 CC0 表示「放弃版权,随便用」;但 CC-BY 要求你署名作者。用的时候要看清楚是哪种,CC-BY 记得在游戏说明里注明作者。
红线三:知名 IP 的素材绝对不能碰。 任何来自商业游戏的拆包素材(精灵图、音乐、音效)——无论你多喜欢,都不能用。这是最容易被追责的一类。
一条实用原则:不确定来源的素材,就当它不能用。 与其事后删素材返工,不如一开始只用可靠来源。
1.8 配套源码仓库与「Tag 对照法」
1.8.1 为什么要用仓库
学完这本书后,你手里会有一个完整的《酒魂》。但学习的真正难点在于:当你卡在某一步时,怎么知道自己写错在哪?
答案就是配套源码仓库。每章完成后,我都会把那一章的完整代码推送到仓库,并打上一个 Tag。这是一个公开仓库——clone(下载)它不需要登录,你现在就可以下载,当作「标准答案」放在手边:
-
选个放代码的目录。 比如
D:\repos(没有就先新建一个;路径里不要有中文和空格,能省掉很多莫名其妙的坑)。在这个文件夹里右键 →「Open Git Bash here」。 -
clone 并切换到第 1 章:
git clone https://gitee.com/agoodlife/wine-soul-development.git cd wine-soul-development # 进入仓库文件夹——不进目录,checkout 会找不到仓库 git checkout ch01 # 切换到第 1 章的代码状态- 打开
D:\repos\wine-soul-development,看到project.godot等文件,就成功了。
- 打开
如果自己的代码跑不起来,把它和 ch01 的代码对比一下,问题通常立刻现形。
卡住了?
- clone 报 404 或「repository not found」:先在浏览器里打开上面的仓库地址确认能访问;若浏览器也 404,说明仓库尚未发布或地址有更新——以附录 D 和随书资源包里给出的最新地址为准,不影响你继续往下学;
- checkout 报错
pathspec 'ch01' did not match:先执行git tag -l看看仓库里实际有哪些 Tag,可能这一章的 Tag 名略有不同,照着列表里的名字切换即可;- 网速慢 / clone 失败:Gitee 仓库页面右上角有「下载 ZIP」按钮,直接下载解压也是一样的效果(只是没有 Git 历史,不能 checkout 切章——每章 zip 单独下载即可)。
仓库地址与各章的完整对照表,见附录 D《仓库地址与每章 diff 摘要》。
1.8.2 每章 diff 摘要:知道「这一章改了什么」
除了完整代码,本书还会在每章末尾提供一个 diff 摘要——用最简形式列出本章新增/修改了哪些文件。
例如第 1 章的 diff 摘要长这样:
新增:
project.godot 项目配置
main.tscn 主场景(Control + Label)
它的价值在于:当你只想「补一补刚才漏掉的部分」时,不必重看整章。 看一眼 diff 摘要,就知道自己缺了哪几个文件。
1.8.3 为什么用 Tag 而不是分支
你可能会问:为什么用 Tag 对照,而不是给每章开一个分支?
因为 Tag 是只读的存档点。分支是为「并行开发」设计的,而这里我们只需要「回看某一章的状态」。用 Tag 更轻、更清晰,也不会在仓库里堆出 27 个用不上的分支。
建议养成习惯: 每学完一章,在你自己的项目里也打一个 Tag(
git tag ch01)。这样你的学习轨迹本身就是一份可回溯的记录——这在以后做自己的项目时,会是非常宝贵的经验。(前提是你的项目已经做过git init——第 4 章建项目时会一起做,届时从ch04开始打起即可。)
1.9 本章小结
本章我们完成了游戏开发新手的「启蒙第一课」,从认知、基础、路径、工具、素材、源码六个方面,帮你破除迷茫、搭好环境、完成第一个项目。
回顾本章,你已经掌握了:
- 正确认知了游戏开发的难度——明白「难」是结构问题,不是能力问题,学会了拆解复杂问题,克服了「不敢动手」的恐惧;
- 通过自测明确了自己的基础——认清起点和短板,知道哪些能力需要补充,哪些东西完全不需要担心;
- 找到了清晰的学习路径——三条路线对号入座,掌握了新手避坑技巧;
- 安装了核心开发工具——成功安装并配置 Godot 4.7、Git、Gitee,能解决常见的安装问题;
- 摸清了素材的全貌与版权红线——知道《酒魂》需要哪些素材、从哪来、哪些绝对不能碰;
- 了解了配套源码仓库与 Tag 对照法——知道了卡住时怎么自救,以及每章 diff 摘要怎么用;
- 完成了第一个项目——创建了「Hello, 酒魂!」,熟悉了 Godot 的核心操作,完成了从「玩家」到「开发者」的第一步。
请记住:游戏开发没有捷径,每一步的积累都重要。 本章的内容就像是游戏中的「新手教程」,帮你熟悉了基本操作,建立了正确的心态。
下一步,第 2 章我们会聊聊心态与方法论——如何看懂代码示例、如何把 Bug 变成成长的机会、如何在遇到困难时不放弃。这些「软技能」看似不写代码,却决定了你能不能读完这本书、做完这个游戏。
你已经站在游戏开发的起跑线上了。 接下来,就让我们一起出发,一步步打造属于自己的国风酿酒战斗游戏《酒魂》吧!
延伸阅读与资源
以下资源不是必须的,但如果你在本章某处卡住了,或者想深入了解某个主题,它们会很有帮助:
-
Godot 官方文档(中文):https://docs.godotengine.org/zh_CN/ —— 最权威,遇到不懂的 API 第一时间查这里
-
《游戏编程模式》(Robert Nystrom 著,中文版免费在线阅读)—— 本书附录 A 设计模式部分的理论基础,强烈推荐
-
Git 官方入门教程(中文):https://git-scm.com/book/zh —— 如果你想更系统地学习版本控制
-
Godot 中文社区(贴吧 / B 站搜索「Godot 教程」)—— 遇到本书没有覆盖的问题时,这里通常能找到答案

评论0
暂时没有评论