改代码、不用重启!odin-raylib-hot-reload-game-template游戏热重载5步上手实战教程
改代码、不用重启!odin-raylib-hot-reload-game-template游戏热重载5步上手实战教程
odin-raylib-hot-reload-game-template 是一个 Odin + Raylib 游戏模板,已预配置好热重载(Hot Reloading)能力:游戏运行时修改玩法代码并重新编译,游戏会自动加载新代码而无需重启,玩家位置、纹理等游戏状态全部保留。本文带你 5 步完成首次热重载实战。
热重载是什么?为什么值得用 🚀
传统开发流程:改代码 → 重新编译 → 重新运行 → 重新走到你改的那一步。
热重载流程:改代码 → 重新编译 → 游戏自己换上新代码。
这个模板的原理很简单,游戏由两部分组成:
| 部分 | 文件 | 说明 |
|---|---|---|
| 宿主程序 | game_hot_reload.exe |
只负责启动游戏和监听代码变化,基本不用动 |
| 游戏逻辑 | build/hot_reload/game.dll |
你的玩法代码编译成的动态库,被监听、随时可换 |
宿主程序会持续检查 game.dll 的修改时间,一旦发现变化就重新加载,并把旧的 Game_Memory(游戏内存状态)交给新代码——这就是"状态不丢"的关键。
第 1 步:准备环境,获取模板代码
- 安装 Odin 编译器(安装后记得把
odin加入系统 PATH 环境变量,构建脚本依赖它) - 获取模板代码:
git clone https://gitcode.com/gh_mirrors/od/odin-raylib-hot-reload-game-template
cd odin-raylib-hot-reload-game-template
Windows 使用
.bat脚本;macOS / Linux 使用.sh脚本(bat换成sh,exe换成bin,dll换成dylib/so)。
第 2 步:首次构建热重载工程
在项目根目录运行:
:: Windows
build_hot_reload.bat
# macOS / Linux
./build_hot_reload.sh
这次运行会生成两个东西:
game_hot_reload.exe(位于项目根目录)game.dll(位于build/hot_reload目录)
构建脚本详见 build_hot_reload.bat 和 build_hot_reload.sh。
第 3 步:运行游戏,保持窗口常驻
运行刚生成的 game_hot_reload.exe,让游戏窗口一直开着不要关。
你会看到一个可以移动的像素小猫(贴图来自 assets/round_cat.png),屏幕左上角显示 some_number 和 player_pos,WASD / 方向键控制移动。
第 4 步:修改玩法代码并保存 ✏️
打开 source/game.odin,把背景色从黑色改成蓝色:
rl.ClearBackground(rl.BLUE) // 原来是 rl.ClearBackground(rl.BLACK)
保存文件。注意:此时游戏窗口还在原样运行,什么都不会发生——先别急,进入下一步。
第 5 步:再次运行构建脚本,见证热重载 ⚡
游戏窗口开着的状态下,再次运行 build_hot_reload.bat(或 .sh):
build_hot_reload.bat
脚本会检测到游戏正在运行,于是只重新编译 game.dll,跳过宿主程序的编译。
游戏窗口会立刻变成蓝色背景——新代码生效了,而你的小猫还在原来的位置,some_number 也没归零。改代码、不用重启,就是这么快。
原理揭秘:状态为什么不会丢?
游戏代码通过 source/game.odin 中几个导出函数与宿主协作:
game_memory:热重载前交出Game_Memory结构体的指针game_hot_reloaded:新 DLL 加载后拿回同一个指针,把全局变量g重新接上
宿主程序的监听与加载逻辑在 source/main_hot_reload/main_hot_reload.odin。另外有两个实用快捷键:
- F5:强制热重载
- F6:强制完整重启(相当于关闭再打开游戏,但不用重启 exe)
小提示:如果
Game_Memory的大小变了(比如加了字段),模板会自动降级为"完整重启"而非热重载,避免崩溃。
进阶玩法:编辑器一键热重载 🔧
模板对主流编辑器都有集成,改完代码一个快捷键搞定编译 + 重载:
- Sublime Text:用 project.sublime-project 打开项目,选择对应构建系统后按
F7即可 - VS Code:用
Run Hot Reload启动任务运行游戏,之后改代码按Ctrl + Shift + B重新构建并热重载(调试需安装 C++ 构建工具或 CodeLLDB) - RAD Debugger:调试器附加到
game_hot_reload上也能持续热重载——脚本会为每次重载生成独立的 PDB,避免调试器锁死符号文件
发布时怎么办?Release 与 Web 构建 📦
热重载只用于开发阶段。正式版本直接用:
- build_release.bat / build_release.sh:生成
build/release下的正式发布版本(普通 Odin 包编译,不含 DLL,assets会被自动复制进去) - build_debug.bat / build_debug.sh:可调试的非热重载版本
- build_web.bat / build_web.sh:Emscripten 构建 Web 版(需先配置
EMSCRIPTEN_SDK_DIR),产物在build/web,可用python -m http.server本地预览
资源文件(贴图、音效、音乐)放在 assets 目录即可,Release 和 Web 构建都会自动带上;Web 端读文件可参考 source/utils.odin 的封装。
总结
| 步骤 | 动作 |
|---|---|
| 1 | 装 Odin、clone 模板 |
| 2 | build_hot_reload 首次构建 |
| 3 | 运行 game_hot_reload 并保持常驻 |
| 4 | 改 source/game.odin 并保存 |
| 5 | 再跑一次 build_hot_reload,秒级热重载 |
从此告别"重开游戏走回测试点"的折磨。把精力放回玩法本身,祝你开发愉快!🎮