raylib 游戏开发库跨平台上手：三条安装路径 + CMake 最小配置一次跑通

raylib 游戏开发库跨平台上手三条安装路径 CMake 最小配置一次跑通【免费下载链接】raylibA simple and easy-to-use library to enjoy videogames programming项目地址: https://gitcode.com/GitHub_Trending/ra/raylibraylib 是一个轻量级、跨平台的 C 语言游戏开发库2D 和 3D 都能写。本文带你走一遍 raylib 安装、验证到可发布构建的完整流程按场景选安装路径CMake 只给最小配置卡住的坑配一张速查表。选一条 raylib 安装路径就够先对号入座。如果你只想跑个 demo 看看效果用包管理器如果你要改源码、做平台定制走源码 CMake 编译如果你要发布独立产品直接用官方模板起项目。三条路径下面都给了验证命令窗口能弹出来就是跑通了。先把仓库拉到本地三条路径的验证示例都从这来git clone https://gitcode.com/GitHub_Trending/ra/raylib cd raylib路径 A包管理器一键装macOS / Windows / Linux 按系统自选# 按系统三选一 brew install raylib # macOS choco install raylib # Windows sudo apt install libraylib-dev # Ubuntu/Debian # 验证编译仓库里最简单的示例窗口弹出即成功 gcc examples/core/core_basic_window.c -o win -lraylib ./win路径 B源码 CMake 编译要改源码、开 CMake 开关就走这条cmake -B build # 配置默认同时编译示例 cmake --build build -j4 # 编译 ./build/examples/core/core_basic_window # 验证窗口弹出即成功路径 C用官方模板起项目projects/CMake/ 里的模板会自动拉取并编译 raylib本地没装也能跑cp -r projects/CMake ~/mygame cd ~/mygame cmake -B build cmake --build build -j4 ./build/example # 模板自带示例能跑说明集成没问题适用场景大概耗时控制力适合谁路径 A 包管理器只想尽快跑 demo5 分钟级低用预编译库第一次接触 raylib路径 B 源码 CMake改源码、跨平台定制15 分钟级含编译高CMake 开关随便调有定制需求的开发者路径 C 官方模板直接开新项目10 分钟级中在模板里改要发布产品的小团队为什么 raylib 装完就能用核心答案它把自己做成了自包含的。所有第三方依赖都内嵌在 src/external/ 里装完 raylib 不用再去系统装别的库这就是开箱即用的来源。关键模块就三类各一句话图形渲染核心rlgl.h封装 OpenGL所有 2D/3D 绘制从这走数学运算raymath.h向量、矩阵、四元数3D 场景必备窗口与输入跨平台建窗口统一处理键盘、鼠标、手柄事件 提示CMake 时加-DCUSTOMIZE_BUILDON能看到音频等模块开关如USE_AUDIO关掉用不到的模块能明显减小库体积。从能跑到能发raylib CMake 最小骨架一个最小可发布项目就两个文件。先看构建文件注意默认就是静态链接不用额外折腾# CMakeLists.txt最小骨架 cmake_minimum_required(VERSION 3.11) project(mygame) find_package(raylib REQUIRED) # 找系统里装好的 raylib add_executable(mygame main.c) target_link_libraries(mygame raylib) # 默认静态链接发布无依赖 # raylib 静态链接Linux 下把标准库也链进去产出独立可执行文件 set_target_properties(mygame PROPERTIES LINK_FLAGS -static)再看程序本体就是 raylib 入门的标准三段初始化、主循环、关闭// main.c最小可运行 #include raylib.h int main(void) { InitWindow(800, 450, my first game); while (!WindowShouldClose()) { BeginDrawing(); ClearBackground(RAYWHITE); DrawText(hello raylib, 340, 200, 20, LIGHTGRAY); EndDrawing(); } CloseWindow(); return 0; }两件事说清楚静态链接上面 CMakeLists 里那一行LINK_FLAGS -static就够了产物是单个可执行文件拷到别的机器直接跑WebAssembly 构建不用改代码把 cmake 命令换成emcmake cmake -B build-web再emmake cmake --build build-web -j4产物是.html扔到任何静态托管就能在浏览器里玩卡住了先跑这条命令别慌四个最高频的问题都在下面这张表里典型现象最可能原因第一反应命令备注fatal error: raylib.h: No such file头文件/库路径没进编译器搜索范围gcc game.c -o game -I/usr/local/include -L/usr/local/lib -lraylib路径换成pkg-config --cflags raylib查到的实际值窗口闪退或黑屏OpenGL 版本太低glxinfo \| grep OpenGL versionraylib 需要 3.3查出来是 2.1 就 cmake 时加-DOPENGL_VERSION2.1有画面没声音缺音频后端库sudo apt install libasound2-dev libpulse-dev装完重编 raylib 即可链接报 GL 符号未定义手工 gcc 时漏了系统库链接行补-lGL -lpthread -ldl走 CMake 则不会遇到raylib 版本怎么选接下来去哪只看最近两个大版本版本最低 OpenGL新增重点注意事项6.02026-043.3软件渲染后端 rlsw 可无 GPU 运行软件渲染后端、新文件系统/文本管理 API、骨骼动画重做、rexm 示例管理器有 API 移除如 GIF 录制升级前翻一遍 CHANGELOG5.52024-113.3GPU 蒙皮、RPC 项目创建工具、RGFW/SDL3 后端、新增主机平台相机射线 API 有改名GetMouseRay→GetScreenToWorldRayraylib 适合 2D 小游戏、教学原型和 Web 端小体量 3D 应用。下一步建议打开 examples/ 示例目录按 core → shapes → textures → models 的顺序挑几个跑比读文档学得快。【免费下载链接】raylibA simple and easy-to-use library to enjoy videogames programming项目地址: https://gitcode.com/GitHub_Trending/ra/raylib创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考