raylib 6.0 安装配置与上手实战从零搭建跨平台 C 语言游戏环境【免费下载链接】raylibA simple and easy-to-use library to enjoy videogames programming项目地址: https://gitcode.com/GitHub_Trending/ra/raylibraylib 是一款用纯 C 编写的轻量级图形库没有外部依赖支持 Windows、Linux、macOS、Raspberry Pi、Android 和 HTML5WebAssembly是 2D/3D 小游戏中型游戏、图形工具和嵌入式显示应用的首选之一。这篇文章带你从零开始三种平台装好 raylib编译运行第一个窗口读懂它的模块架构与 CMake 构建参数并附上一份现象 → 原因 → 命令的排查清单读完你就能独立上手 raylib 开发。1. 为什么选 raylib零依赖 140 个可运行示例这一节先回答raylib 凭什么值得花十分钟装让你带着预期去搭环境。零外部依赖构建 raylib 不需要系统级第三方库窗口管理、图像/音频/模型解码等所需组件全部内嵌在 src/external/详见 README.md。纯 C99 编写API 命名直观src/raylib.h 头文件本身就是文档。examples/ 目录带 140 示例按模块core/shapes/textures/models/audio/shaders分类官方定位就是以示例为教材。跨平台一套源码Windows、LinuxX11/Wayland、macOS、FreeBSD、Raspberry Pi含无窗口 DRM 模式、Android、HTML5。⚠️ 先有预期raylib 是库不是引擎。它没有界面管理器、对象编辑器、资源管理器官方定位就是最纯粹的编码体验一切游戏逻辑都自己写——这对想搞懂底层的人来说反而是优点。2. 三种平台安装 raylib包管理器 vs 源码编译这一节解决我的系统怎么拿到 libraylib先给可直接复制的命令最后附统一验证代码。2.1 用包管理器安装适合快速验证平台安装命令前置条件WindowsMSYS2/MinGW64pacman -S mingw-w64-ucrt-x86_64-raylibMSYS2 与 gcc或 MinGW-w64macOSbrew install raylibXcode 命令行工具Ubuntu/Debiansudo apt install libraylib-devlibx11-dev、libxrandr-dev、libxi-devArch Linuxsudo pacman -S raylibmeson、ninja包管理器自动处理2.2 用 CMake 从源码编译推荐可控性最强# 克隆源码当前稳定版 6.0见 CHANGELOG 头部 git clone https://gitcode.com/GitHub_Trending/ra/raylib cd raylib # 配置 编译 安装CMake 版本需 3.22见 CMakeLists.txt 第 1 行 mkdir build cd build cmake -S .. -B . -DCMAKE_BUILD_TYPEDebug -DBUILD_EXAMPLESON cmake --build . --config Release -j$(nproc) sudo cmake --install .用 Makefile 构建也可以cd src make installLinux 默认走 GLFW X11 后端见 src/Makefile。CMake 方式默认生成静态库BUILD_SHARED_LIBS默认 OFF想要动态库加-DBUILD_SHARED_LIBSON。✅ 验证清单配置阶段终端打印Building raylib static library、PLATFORM、GRAPHICS三行信息安装后存在/usr/local/lib/libraylib.a与/usr/local/include/raylib.h下一节的第一窗口程序能编译、能弹窗、能正常关闭2.3 编译你的第一个 raylib 程序把 README 里的第一窗口示例存为first_window.c#include raylib.h int main(void) { InitWindow(800, 450, raylib example - basic window); while (!WindowShouldClose()) { BeginDrawing(); ClearBackground(RAYWHITE); DrawText(Congrats! You created your first window!, 190, 200, 20, LIGHTGRAY); EndDrawing(); } CloseWindow(); return 0; }按平台选择对应链接命令静态库路径按你的安装位置调整# Linuxraylib 的私有依赖需要显式带上 gcc first_window.c -o first_window -I/usr/local/include -L/usr/local/lib -lraylib -lpthread -ldl -lm -lX11# macOS必须补上 GLFW 内嵌后端用到的框架 gcc first_window.c -o first_window -I/usr/local/include -L/usr/local/lib -lraylib -lm -framework Cocoa -framework IOKit -framework QuartzCore -framework OpenGL# WindowsMSYS2 MinGW64 gcc first_window.c -o first_window.exe -lraylib -lopengl32 -lgdi32 -lwinmm✅ 预期结果弹出 800×450 的白底窗口中央显示 Congrats! You created your first window!点关闭按钮程序干净退出无报错。raylib 第一窗口示例运行效果白底窗口居中显示欢迎文本examples/core/core_basic_window.c2.4 一次性构建全部 140 示例# 方式一CMake上面若已加 -DBUILD_EXAMPLESON 则跳过本步 cmake --build . -j$(nproc) # 可执行文件输出在 build/examples/ 下资源同目录 resources/ # 方式二Makefile只编单个示例快 cd examples make core_basic_window PLATFORMPLATFORM_DESKTOP ./core_basic_window跑两个值得留意的models_textured_cube3D 纹理立方体和core_3d_camera_first_personWASD 鼠标的第一人称相机。models_textured_cube 运行效果旋转的纹理立方体验证 3D 模型与纹理管线examples/models/models_textured_cube.ccore_3d_camera_first_person 运行效果WASD 移动 鼠标控制视角验证相机系统examples/core/core_3d_camera_first_person.c3. 读懂架构一个头文件七个模块一套内嵌依赖这一节解决raylib 内部长什么样、我改哪里能裁剪功能只讲你写业务代码和做构建时真正需要知道的。Raylib 采用模块化的单库设计公共 API 全部聚合在 src/raylib.h底层由一组.c模块文件拼成源文件模块职责能否裁剪rcore.crcore窗口、事件、键盘/鼠标/手柄、文件、计时核心不可裁剪rlgl.hrlglOpenGL 抽象层1.1/2.1/3.3/ES2/ES3/软件渲染可独立使用核心不可裁剪rshapes.crshapes2D 几何图元绘制可以SUPPORT_MODULE_RSHAPESrtextures.crtextures图像/纹理加载与处理可以SUPPORT_MODULE_RTEXTURESrtext.crtext字体与文字绘制依赖 rtextures可以SUPPORT_MODULE_RTEXTrmodels.crmodels3D 模型、骨骼动画OBJ/IQM/glTF/VOX/M3D可以SUPPORT_MODULE_RMODELSraudio.craudio音频解码与播放WAV/OGG/MP3/QOA/XM/MOD可以SUPPORT_MODULE_RAUDIOraymath.hraymath向量/矩阵/四元数纯头文件头文件按需引用平台相关实现按目标拆在 src/platforms/GLFW/SDL/RGFW/Win32/Web/DRM/Android/Memory 各一套。裁剪逻辑就写在 src/CMakeLists.txtSUPPORT_MODULE_RAUDIO、SUPPORT_MODULE_RMODELS之类的开关决定是否把模块源文件编进raylib目标默认全开。所有第三方库内嵌在 src/external/窗口与输入glfw/默认后端、RGFW/可选后端图像stb_image.h、stb_image_write.h、stb_truetype.h音频miniaudio.h、dr_wav.h、dr_mp3.h、dr_flac.h模型tinyobj_loader_c.h、cgltf.h、vox_loader.h、m3d.h 因为依赖全部内嵌你不需要为了编译 raylib 去装任何系统级图形/音频库只有链接你自己的程序时才需要按 2.3 的平台清单补-lpthread -ldl -lm -lX11Linux或 Cocoa/IOKit/OpenGL 框架macOS。进阶构建 WebAssembly 版本# 需要 Emscripten 工具链PLATFORMWeb 时 CMake 默认走 Emscripten 流程 emcmake cmake -S . -B build-web -DCMAKE_BUILD_TYPERelease emmake cmake --build build-web # 产物是 *.html直接丢进浏览器或静态服务器即可运行4. CMake 构建参数速查表这一节把 CMakeOptions.txt 里你实际会用到的开关汇总成一张表遇到需求直接查。参数可选值默认作用PLATFORMDesktop / Win32 / Web / WebRGFW / Android / Raspberry Pi / DRM / SDL / RGFW / MemoryDesktop目标平台Memory 软件渲染帧缓冲无 OS 要求OPENGL_VERSION4.3 / 3.3 / 2.1 / 1.1 / ES 2.0 / ES 3.0 / Software平台默认强制指定图形 API 版本驱动太老就降到 3.3 或 2.1BUILD_EXAMPLESON / OFFON顶层构建时是否连 140 示例一起编译CUSTOMIZE_BUILDON / OFFOFF打开后才能逐项开关 src/config.h 里的模块与文件格式USE_AUDIOON / OFFON开CUSTOMIZE_BUILD后控制 raudio 模块SUPPORT_MODULE_RAUDIO/SUPPORT_MODULE_RMODELSON / OFFON配合CUSTOMIZE_BUILD裁剪对应模块BUILD_SHARED_LIBSON / OFFOFF生成动态库.so/.dylib/.dllWITH_PICON / OFFOFF静态库按位置无关代码编译便于链进动态库GLFW_BUILD_X11/GLFW_BUILD_WAYLANDON / OFFX11ONWaylandOFFLinux 窗口协议选择两者不能同时关USE_EXTERNAL_GLFWOFF / IF_POSSIBLE / ONOFF优先链系统 GLFW 而非内嵌版ENABLE_ASAN/ENABLE_UBSANON / OFFOFF开内存/未定义行为检测性能下降仅调试用示例裁剪掉 3D 模块 关闭音频得到一个更小的 2D 专用库cmake -S . -B build-2d -DCUSTOMIZE_BUILDON \ -DSUPPORT_MODULE_RMODELSOFF -DUSE_AUDIOOFF5. 编译报错自查清单现象 → 原因 → 命令这一节按你看到的报错索引每条给排查链路不用通读。现象可能原因处理命令fatal error: raylib.h: No such file or directory头文件路径没传给编译器gcc ... -I/usr/local/include或改用 CMake 工程见第 7 节Linux 链接期cannot find -lraylib只装了源码没装库或库在别的目录先sudo cmake --install .自定义路径加-L/你的/库目录undefined reference to X链接你自己的程序时静态库的私有依赖没补齐Linux 补-lpthread -ldl -lm -lX11macOS 补-framework Cocoa -framework IOKit -framework QuartzCore -framework OpenGL启动即崩溃 / 报GLFW error: No windowing systemX11 开发库缺失Ubuntu 常见sudo apt install libx11-dev libxrandr-dev libxi-devFailed to create GL context显卡驱动只支持低于 OpenGL 3.3 的旧 API先glxinfo | grep OpenGL version确认版本再-DOPENGL_VERSION2.1重新配置编译 raylib编译成功但无声音频模块被裁掉或系统无音频设备确认构建日志含Audio Backend: miniaudio检查aplay -lLinux输出Wayland 会话下窗口异常默认后端是 X11-DGLFW_BUILD_WAYLANDON -DGLFW_BUILD_X11OFF重新配置升级 raylib 后示例编译不过6.x 有 API 重命名如ImageDraw()改为对齐DrawTexture()查 CHANGELOG 中标了-WARNING-的条目6. 版本、平台与图形 API 对照这一节给你一张现在该用什么的参照表跨机器协作时尤其有用。当前稳定版raylib 6.02026-04-23 发布见 CHANGELOG 首行API_VERSION 600构建要求CMake ≥ 3.22任意 C99 编译器图形后端OpenGL 1.1 / 2.1 / 3.3 / 4.3 / ES 2.0 / ES 3.0另有无需 GPU 的 Softwarerlsw后端文件 src/CMakeLists.txt 第 3 行写死了PROJECT_VERSION 6.0.0升级或降级时以 CHANGELOG 顶部 Current Release 为准平台窗口后端图形 API备注WindowsGLFW / 原生 Win32OpenGL 1.1~4.3MinGW-w64 或 MSVCLinux 桌面GLFW默认 X11可切 Wayland/ SDL / RGFWOpenGL 2.1~4.3X11 需装 x11 开发包Linux 无窗口Raspberry Pi 等DRMOpenGL 或 SoftwarePLATFORMDRMmacOSGLFWOpenGL系统自带10.14 起标记弃用需链接 Cocoa/IOKit/QuartzCore 框架AndroidNDKOpenGL ES 3.0-DPLATFORMAndroidHTML5EmscriptenGLFW 或 RGFWWebGL产物.html直接部署嵌入式/无 OS内存帧缓冲 rlsw 软件渲染无-DPLATFORMMemory7. 接入你的 IDE 与工程模板这一节解决我不想手敲 gcc 命令行。仓库 projects/ 目录自带多套现成模板模板位置适用场景CMake 模板projects/CMake/通用 CMake 工程配置阶段自动find_package(raylib)本机没装则 FetchContent 拉取 6.0 源码编译并生成compile_commands.jsonVSCode Clangd/IntelliSense 直接受益Visual Studio 2022projects/VS2022/完整 .sln 全部示例工程VS Codeprojects/VSCode/Makefile 工作区模板Code::Blocksprojects/CodeBlocks/.cbp 工程CMake 模板的最小改动路径# 拷贝模板后把示例源文件换成你的 main.c cp -r projects/CMake my_game cd my_game mkdir build cd build cmake .. cmake --build . ./example 如果你已经按第 2.2 节cmake --install过 raylib模板里的find_package(raylib 6.0 QUIET)会直接命中系统库不会走网络拉取。8. 下一步往哪走raylib 的学习路径官方就一句话直接读示例。examples/ 按模块分目录并标注了难度建议顺序core窗口/相机/输入→ shapes2D 绘制→ textures精灵/动画→ models3D→ shaders后处理。遇到不认识的 API 就打开 src/raylib.h 找注释或翻 tools/rlparser/output/ 下的 API 清单txt/json/xml 都有。要贡献代码先读 CONVENTIONS.md要确认某个行为是 bug 还是新特性先查 CHANGELOG 里的 WARNING 条目。把first_window跑起来的那一刻环境就齐了——剩下的只是把窗口里的静态文字换成你的游戏循环。【免费下载链接】raylibA simple and easy-to-use library to enjoy videogames programming项目地址: https://gitcode.com/GitHub_Trending/ra/raylib创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考