raylib安装与环境搭建手把手从克隆仓库到跑通第一个窗口【免费下载链接】raylibA simple and easy-to-use library to enjoy videogames programming项目地址: https://gitcode.com/GitHub_Trending/ra/raylib如果你以为配一个游戏库要折腾几十分钟装系统依赖raylib 可能会让你意外它把全部第三方库直接塞进了源码树的 src/external/ 目录克隆仓库后跑一遍 CMake 就能得到静态库和上百个可运行示例。这篇文章带你完成 raylib 安装与环境搭建的完整流程克隆仓库 → CMake 三条命令编译 → 验证第一个窗口跑起来中途还会拆解常用构建参数和新手最容易踩的三个坑全部命令均可复制直接执行。仓库长什么样先认路再动手编译前先花 30 秒认识目录后面排错时你会感谢这一步路径作用src/库本体raylib.h 主头文件、rlgl.h OpenGL 抽象层、raymath.h 数学模块、raudio.c 音频模块src/external/全部内嵌的第三方依赖GLFW、miniaudio、stb 系列等这就是零外部依赖的来源examples/140 个按模块分目录的示例每个.c旁边配一张运行效果截图projects/各 IDE 的项目模板VS2022、CMake、VSCode、CodeBlocks 等CMakeOptions.txt所有 CMake 构建开关的定义想调什么参数先来这里查克隆、配置、编译三条命令搭好环境仓库里同时提供了 CMake 和 Makefile 两套构建系统CMake 是主路径要求 CMake 3.22 及以上用cmake --version先确认低了会被配置阶段直接拒绝git clone https://gitcode.com/GitHub_Trending/ra/raylib cd raylib cmake -B build -S . -DCMAKE_BUILD_TYPERelease cmake --build build -j4说明两句不带CMAKE_BUILD_TYPE时 CMake 默认按 Debug 构建日常验证没关系正式发布记得带上Release。顶层构建默认开启BUILD_EXAMPLES所以这条命令会连示例一起编好省得你回头再折腾一遍。Windows 用户装好 MinGW 或 MSYS2 后流程相同可加-G MinGW Makefiles指定生成器Linux/macOS 无需任何附加参数。编完后验证两个产物ls build/raylib/libraylib.a应能看到静态库build/examples/下应有一排可执行文件。缺任何一个都说明构建没走完往上翻编译日志找第一条 error。跑第一个窗口确认环境真的通了编译成功的最终检验是看到窗口弹出来而不是没有报错./build/examples/core_basic_windowLinux/macOS 下路径同上Windows 下在build\examples\里找到core_basic_window.exe双击运行。正常的话会弹出一个 800x450 的窗口中间显示一行 Congrats! You created your first window!终端同时打印出你的显卡和 OpenGL 版本信息——这就是 raylib 的启动自检黑屏或闪退基本都发生在这一层。这个示例的全部逻辑不到 20 行核心就是一个初始化加循环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();完整源码在 examples/core/core_basic_window.c照着它改窗口标题和文字就是你的第一个 raylib 项目。按环境调构建四个最实用的参数所有开关集中在 CMakeOptions.txt日常最常用的是下面四个配置阶段加-D即可参数可选值什么时候用PLATFORMDesktop默认、Win32、Web、Android、Raspberry Pi、DRM、SDL、RGFW等目标不是普通桌面环境时切换OPENGL_VERSION默认OFF自动探测可强制4.3/3.3/2.1等还有Software软渲染老显卡或无 GPU 的机器BUILD_SHARED_LIBS默认OFF静态库想要 .so/.dll 共享库时设为ONCUSTOMIZE_BUILDON后展开USE_AUDIO等模块级开关想砍掉不用的模块减小体积时典型用法比如给老显卡降到 OpenGL 2.1 并只留核心模块cmake -B build -S . -DOPENGL_VERSION2.1 -DCUSTOMIZE_BUILDON配置阶段终端会打印 Audio Backend: miniaudio 之类的摘要行改完参数后先看一眼这些行确认开关按预期生效。不想用 CMake 也可以走仓库自带的 Makefilemake -C src RAYLIB_LIBTYPESTATIC编库再make -C examples RAYLIB_LIBTYPESTATIC PLATFORMPLATFORM_DESKTOP编示例变量含义都能翻到 src/Makefile 顶部。编译不过先查这三处1. CMake 版本报错。配置阶段提示需要 3.22 以上说明系统自带的 CMake 太老。cmake --version确认后升级 CMake 本身即可不要试图改 CMakeLists.txt 里的最低版本要求——它依赖了新版本才有的策略开关。2. Linux 缺开发头文件。报X11 not found、GL/gl.h not found这类错是缺 OpenGL 和 X11 的开发包raylib 桌面后端默认用内嵌 GLFW 走 X11src/Makefile 里GLFW_LINUX_ENABLE_X11默认为真。Debian/Ubuntu 系装libgl1-mesa-dev libxi-dev libxrandr-dev libxinerama-dev libxcursor-dev即可。注意 CMake 会强制X11 和 Wayland 至少开一个两个都关会直接 FATAL_ERROR。3. 窗口能编出但运行黑屏/闪退。通常是 OpenGL 版本低于要求看终端启动日志里打印的版本号然后按上一节的OPENGL_VERSION降档完全无 GPU 的环境可以试OPENGL_VERSIONSoftware软渲染后端。想用现成 IDE 模板直接进 projects/projects/ 下每个子目录都是一份可打开的工程VS2022 有完整的 raylib.sln 和全部示例工程文件projects/CMake/ 是独立 CMake 模板VSCode、CodeBlocks、Geany、Notepad、SublimeText、Zig 也各有一份。拿模板的好处是编译器和头文件路径都配好了你只需把示例源码拷进工程开写。回到主线克隆、两条 CMake 命令、看到第一个窗口raylib 的环境搭建就闭环了。后续想深入功能细节从 examples/ 里按模块挑示例读源码比查文档更直接平台特性和设计问题的答案在 FAQ.md 里构建行为的修改记录可以看 CHANGELOG。【免费下载链接】raylibA simple and easy-to-use library to enjoy videogames programming项目地址: https://gitcode.com/GitHub_Trending/ra/raylib创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 
长河君 · 2026/9/2 9:42:06 · 阅读 1.2k raylib安装与环境搭建：手把手从克隆仓库到跑通第一个窗口
raylib安装与环境搭建手把手从克隆仓库到跑通第一个窗口【免费下载链接】raylibA simple and easy-to-use library to enjoy videogames programming项目地址: https://gitcode.com/GitHub_Trending/ra/raylib如果你以为配一个游戏库要折腾几十分钟装系统依赖raylib 可能会让你意外它把全部第三方库直接塞进了源码树的 src/external/ 目录克隆仓库后跑一遍 CMake 就能得到静态库和上百个可运行示例。这篇文章带你完成 raylib 安装与环境搭建的完整流程克隆仓库 → CMake 三条命令编译 → 验证第一个窗口跑起来中途还会拆解常用构建参数和新手最容易踩的三个坑全部命令均可复制直接执行。仓库长什么样先认路再动手编译前先花 30 秒认识目录后面排错时你会感谢这一步路径作用src/库本体raylib.h 主头文件、rlgl.h OpenGL 抽象层、raymath.h 数学模块、raudio.c 音频模块src/external/全部内嵌的第三方依赖GLFW、miniaudio、stb 系列等这就是零外部依赖的来源examples/140 个按模块分目录的示例每个.c旁边配一张运行效果截图projects/各 IDE 的项目模板VS2022、CMake、VSCode、CodeBlocks 等CMakeOptions.txt所有 CMake 构建开关的定义想调什么参数先来这里查克隆、配置、编译三条命令搭好环境仓库里同时提供了 CMake 和 Makefile 两套构建系统CMake 是主路径要求 CMake 3.22 及以上用cmake --version先确认低了会被配置阶段直接拒绝git clone https://gitcode.com/GitHub_Trending/ra/raylib cd raylib cmake -B build -S . -DCMAKE_BUILD_TYPERelease cmake --build build -j4说明两句不带CMAKE_BUILD_TYPE时 CMake 默认按 Debug 构建日常验证没关系正式发布记得带上Release。顶层构建默认开启BUILD_EXAMPLES所以这条命令会连示例一起编好省得你回头再折腾一遍。Windows 用户装好 MinGW 或 MSYS2 后流程相同可加-G MinGW Makefiles指定生成器Linux/macOS 无需任何附加参数。编完后验证两个产物ls build/raylib/libraylib.a应能看到静态库build/examples/下应有一排可执行文件。缺任何一个都说明构建没走完往上翻编译日志找第一条 error。跑第一个窗口确认环境真的通了编译成功的最终检验是看到窗口弹出来而不是没有报错./build/examples/core_basic_windowLinux/macOS 下路径同上Windows 下在build\examples\里找到core_basic_window.exe双击运行。正常的话会弹出一个 800x450 的窗口中间显示一行 Congrats! You created your first window!终端同时打印出你的显卡和 OpenGL 版本信息——这就是 raylib 的启动自检黑屏或闪退基本都发生在这一层。这个示例的全部逻辑不到 20 行核心就是一个初始化加循环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();完整源码在 examples/core/core_basic_window.c照着它改窗口标题和文字就是你的第一个 raylib 项目。按环境调构建四个最实用的参数所有开关集中在 CMakeOptions.txt日常最常用的是下面四个配置阶段加-D即可参数可选值什么时候用PLATFORMDesktop默认、Win32、Web、Android、Raspberry Pi、DRM、SDL、RGFW等目标不是普通桌面环境时切换OPENGL_VERSION默认OFF自动探测可强制4.3/3.3/2.1等还有Software软渲染老显卡或无 GPU 的机器BUILD_SHARED_LIBS默认OFF静态库想要 .so/.dll 共享库时设为ONCUSTOMIZE_BUILDON后展开USE_AUDIO等模块级开关想砍掉不用的模块减小体积时典型用法比如给老显卡降到 OpenGL 2.1 并只留核心模块cmake -B build -S . -DOPENGL_VERSION2.1 -DCUSTOMIZE_BUILDON配置阶段终端会打印 Audio Backend: miniaudio 之类的摘要行改完参数后先看一眼这些行确认开关按预期生效。不想用 CMake 也可以走仓库自带的 Makefilemake -C src RAYLIB_LIBTYPESTATIC编库再make -C examples RAYLIB_LIBTYPESTATIC PLATFORMPLATFORM_DESKTOP编示例变量含义都能翻到 src/Makefile 顶部。编译不过先查这三处1. CMake 版本报错。配置阶段提示需要 3.22 以上说明系统自带的 CMake 太老。cmake --version确认后升级 CMake 本身即可不要试图改 CMakeLists.txt 里的最低版本要求——它依赖了新版本才有的策略开关。2. Linux 缺开发头文件。报X11 not found、GL/gl.h not found这类错是缺 OpenGL 和 X11 的开发包raylib 桌面后端默认用内嵌 GLFW 走 X11src/Makefile 里GLFW_LINUX_ENABLE_X11默认为真。Debian/Ubuntu 系装libgl1-mesa-dev libxi-dev libxrandr-dev libxinerama-dev libxcursor-dev即可。注意 CMake 会强制X11 和 Wayland 至少开一个两个都关会直接 FATAL_ERROR。3. 窗口能编出但运行黑屏/闪退。通常是 OpenGL 版本低于要求看终端启动日志里打印的版本号然后按上一节的OPENGL_VERSION降档完全无 GPU 的环境可以试OPENGL_VERSIONSoftware软渲染后端。想用现成 IDE 模板直接进 projects/projects/ 下每个子目录都是一份可打开的工程VS2022 有完整的 raylib.sln 和全部示例工程文件projects/CMake/ 是独立 CMake 模板VSCode、CodeBlocks、Geany、Notepad、SublimeText、Zig 也各有一份。拿模板的好处是编译器和头文件路径都配好了你只需把示例源码拷进工程开写。回到主线克隆、两条 CMake 命令、看到第一个窗口raylib 的环境搭建就闭环了。后续想深入功能细节从 examples/ 里按模块挑示例读源码比查文档更直接平台特性和设计问题的答案在 FAQ.md 里构建行为的修改记录可以看 CHANGELOG。【免费下载链接】raylibA simple and easy-to-use library to enjoy videogames programming项目地址: https://gitcode.com/GitHub_Trending/ra/raylib创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考