raylib 安装到发布5 个 Level 跑通 CMake 最小配置与跨平台构建【免费下载链接】raylibA simple and easy-to-use library to enjoy videogames programming项目地址: https://gitcode.com/GitHub_Trending/ra/raylibraylib 是一款轻量级、跨平台的 C 语言游戏开发库2D 和 3D 都能写。这篇 raylib 教程带你走完全流程选一条 raylib 安装路径弹出第一个窗口看懂库的自包含设计用 CMake 拿到一个静态链接的可发布最小工程再备一张故障速查表和版本选择建议。全程五关照着敲命令就能通关。Level 15 分钟安装 raylib 并弹出第一个窗口先对号入座。三种安装方式选一条最贴合你场景的跑完验证命令窗口弹出即成功。路径 A包管理器一键装 raylib只想尽快跑个 demo# 按系统三选一 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 开关git clone https://gitcode.com/GitHub_Trending/ra/raylib cd raylib 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 分钟级低用预编译库第一次接触 raylibB 源码 CMake改源码、跨平台定制15 分钟级含编译高CMake 开关随便调有定制需求的开发者C 官方模板直接开新项目10 分钟级中在模板里改要发布产品的小团队Level 2透视 raylib凭什么装完就能跑结论raylib 是自包含的所有第三方依赖都内嵌在 src/external/装完不用再去系统装别的库这就是开箱即用的来源。核心模块就三类各一句话图形渲染src/rlgl.h封装 OpenGL所有 2D/3D 绘制从这走数学运算src/raymath.h向量、矩阵、四元数3D 场景必备窗口与输入跨平台建窗口统一处理键盘、鼠标、手柄事件 提示CMake 配置时加-DCUSTOMIZE_BUILDON能看到USE_AUDIO这类模块开关定义在 CMakeOptions.txt关掉用不到的模块能明显减小库体积。Level 3两个文件的可发布工程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; }两件事说清楚静态链接上面那一行LINK_FLAGS -static就够了产物是单个可执行文件拷到别的机器直接跑WebAssembly 构建不用改代码把 cmake 换成emcmake cmake -B build-web再emmake cmake --build build-web -j4产物是.html扔到任何静态托管就能在浏览器里玩Level 4出错了四行命令自救别慌四个最高频的问题都在下面这张表里。典型现象最可能原因第一反应命令备注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 版本怎么挑下一站去哪只看最近两个大版本当前仓库处于 6.1-dev 阶段版本最低 OpenGL新增重点注意事项6.02026-043.3软件渲染后端 rlsw 可无 GPU 运行软件渲染后端、新文件系统/文本管理 API、骨骼动画重做、rexm 示例管理器有 API 移除如 GIF 录制升级前翻一遍 CHANGELOG5.52024-113.3GPU 蒙皮、RPC 项目创建工具、RGFW/SDL3 后端、新增主机平台相机射线 API 改名GetMouseRay→GetScreenToWorldRay下一站打开 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），仅供参考