企业官网建设流程全解析

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 only，Debian/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-dev

• cmake：仓库的 CMakeLists.txt 要求 CMake ≥ 3.22
• libxi-dev等：X11 输入/屏幕扩展
• libgl1-mesa-dev、libasound2-dev：OpenGL 与 ALSA 音频

Windows：用 CMake 生成器或现成工程

:: Windows only，MinGW 或 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直接编译，因为它已经配好了包含目录和链接库。

macOS：Homebrew 一条命令

# 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_TYPE=Release cmake --build build -j

配置阶段值得记住的四个选项（完整清单见 CMakeOptions.txt）：

• PLATFORM：默认Desktop，可选Win32、Web、SDL、RGFW等
• OPENGL_VERSION：取OFF;4.3;3.3;2.1;1.1;ES 2.0;ES 3.0;Software
• BUILD_SHARED_LIBS：默认 OFF，静态库适合直接分发可执行文件
• CUSTOMIZE_BUILD：打开后显示模块开关，可按需关掉USE_AUDIO等

老显卡或远程桌面黑屏时，指定 OpenGL 版本重新配置：

cmake -B build -S . -DOPENGL_VERSION=3.3

5分钟验证：编译并运行基础窗口示例

装完不要凭"没报错"就认为成功。编译仓库里的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_VERSION=3.3（或2.1）重新配置构建。

第二里程碑：3D 渲染链路验证

第一个窗口过了，再编译examples/models/models_textured_cube.c。它跑通说明模型加载、材质贴图、相机和光照整条 3D 链路都正常，之后遇到的图形问题大概率出在你自己的代码里。

跑通之后往哪走

• 逐个编译examples/shaders/下的着色器示例，每个都是独立可运行的视觉实验
• 把build/CMakeCache.txt里的关键选项抄进笔记并提交到你的版本库，环境就跟着代码一起可复现
• 留意 CHANGELOG：6.1 开发版重写了 Image 与 File API，跨 minor 版本迁移前先读一遍变更清单

【免费下载链接】raylibA simple and easy-to-use library to enjoy videogames programming项目地址: https://gitcode.com/GitHub_Trending/ra/raylib