raylib环境配置从源码到第一个窗口的3个里程碑【免费下载链接】raylibA simple and easy-to-use library to enjoy videogames programming项目地址: https://gitcode.com/GitHub_Trending/ra/raylib按时间顺序走三个里程碑装好构建环境、跑通第一个窗口、验证 3D 渲染链路。走完你就有一条可验证的 raylib 开发环境外加一份自己调过的 CMake 配置。每个里程碑都有明确的验证动作哪一步卡住就走对应的分支不用从头再来。第一个窗口选一条安装路径并装好构建工具目标只有一个让编译器能链接到 raylib。按你的系统选下面任一路径。Linux包管理器优先缺位就走源码先在发行版仓库里找预编译包因为包管理器会顺手装好 X11、OpenGL、ALSA 这些系统依赖# Linux onlyDebian/Ubuntu 系 apt-cache search raylib # 查看仓库是否收录 raylib 开发包如果查不到或版本落后太多直接走源码路径。源码路径是默认选择仓库内置了全部第三方依赖GLFW、stb、miniaudio 都在src/external/里不需要额外装图形库之外的东西。先装构建工具链# Linux only sudo apt install build-essential cmake git libgl1-mesa-dev libxi-dev libxrandr-dev libxcursor-dev libasound2-devcmake仓库的 CMakeLists.txt 要求 CMake ≥ 3.22libxi-dev等X11 输入/屏幕扩展libgl1-mesa-dev、libasound2-devOpenGL 与 ALSA 音频Windows用 CMake 生成器或现成工程:: Windows onlyMinGW 或 MSVC 均可 git clone https://gitcode.com/GitHub_Trending/ra/raylib cd raylib cmake -B build -G MinGW Makefiles cmake --build build --config Release不想写命令的话仓库自带 VS2022 工程文件用 Visual Studio 打开projects/VS2022/raylib.sln直接编译因为它已经配好了包含目录和链接库。macOSHomebrew 一条命令# macOS brew install raylib推荐 Homebrew因为它替你把 Cocoa、OpenGL、CoreAudio 等系统框架都处理了。坚持用 Xcode 也没问题在项目构建设置里手动添加-framework Cocoa、-framework OpenGL、-framework CoreAudio、-framework IOKit、-framework CoreVideo再#include raylib.h即可。手动路径源码编译与 CMake 关键选项需要 6.1-dev 的新特性、或想控制构建细节时用这条路径。先克隆仓库git clone https://gitcode.com/GitHub_Trending/ra/raylib cd raylib cmake -B build -S . -DCMAKE_BUILD_TYPERelease cmake --build build -j配置阶段值得记住的四个选项完整清单见 CMakeOptions.txtPLATFORM默认Desktop可选Win32、Web、SDL、RGFW等OPENGL_VERSION取OFF;4.3;3.3;2.1;1.1;ES 2.0;ES 3.0;SoftwareBUILD_SHARED_LIBS默认 OFF静态库适合直接分发可执行文件CUSTOMIZE_BUILD打开后显示模块开关可按需关掉USE_AUDIO等老显卡或远程桌面黑屏时指定 OpenGL 版本重新配置cmake -B build -S . -DOPENGL_VERSION3.35分钟验证编译并运行基础窗口示例装完不要凭没报错就认为成功。编译仓库里的examples/core/core_basic_window.c运行后应弹出一个 800×450 的窗口显示 Congrats! You created your first window!。这一屏同时验证了窗口创建、渲染循环和文字绘制。分支一报raylib.h: No such file or directory。头文件没进编译器搜索路径。装到/usr/local时手动指定# Linux only gcc -I/usr/local/include -L/usr/local/lib examples/core/core_basic_window.c -lraylib -lGL -lm -o win分支二窗口能开但内容黑屏。多半是 OpenGL 版本不匹配查一下当前会话实际支持的版本# Linux only glxinfo | grep OpenGL version按输出里最高的版本用-DOPENGL_VERSION3.3或2.1重新配置构建。第二里程碑3D 渲染链路验证第一个窗口过了再编译examples/models/models_textured_cube.c。它跑通说明模型加载、材质贴图、相机和光照整条 3D 链路都正常之后遇到的图形问题大概率出在你自己的代码里。跑通之后往哪走逐个编译examples/shaders/下的着色器示例每个都是独立可运行的视觉实验把build/CMakeCache.txt里的关键选项抄进笔记并提交到你的版本库环境就跟着代码一起可复现留意 CHANGELOG6.1 开发版重写了 Image 与 File API跨 minor 版本迁移前先读一遍变更清单【免费下载链接】raylibA simple and easy-to-use library to enjoy videogames programming项目地址: https://gitcode.com/GitHub_Trending/ra/raylib创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考