改代码、不用重启!odin-raylib-hot-reload-game-template游戏热重载5步上手实战教程

原创2026-11-13 13:48:482,192 阅读

改代码、不用重启!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 构建 📦

热重载只用于开发阶段。正式版本直接用:

资源文件(贴图、音效、音乐)放在 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,秒级热重载

从此告别"重开游戏走回测试点"的折磨。把精力放回玩法本身,祝你开发愉快!🎮

登录后查看全文
odin-raylib-hot-reload-game-template