raylib 使用指南：用 C 语言快速做游戏

一、介绍

raylib 是一个"简单易用"是第一设计原则的跨平台游戏开发库，用 C99 编写，核心目标是让开发者——尤其是初学者——能用最少的样板代码，把窗口、图形、音频、输入这些游戏开发的基础设施快速搭起来，专注在"做游戏"这件事本身，而不是和底层图形 API 或平台差异纠缠。它底层基于 OpenGL（1.1、2.1、3.3、ES2 均支持，由内部封装层 rlgl 抽象），同时支持 Windows、Linux、macOS、Android、Web（通过 Emscripten 编译到 WebAssembly）以及树莓派等平台。

raylib 的作者 Ramon Santamaria 常年坚持"raylib 是用来学习编程和游戏开发的工具"，因此它的 API 设计极其克制、命名清晰、几乎没有隐藏的魔法，一个函数名基本就能猜出它做什么。这也让它在 C 语言游戏开发、游戏编程教学、Game Jam 快速原型开发中非常受欢迎。

二、特性

• 窗口与上下文管理：一行 InitWindow 即可创建窗口和 OpenGL 上下文。
• 2D/3D 图形绘制：内置基础图形绘制、纹理加载、字体渲染、3D 模型加载（OBJ、glTF、IQM 等格式）。
• 输入处理：统一封装键盘、鼠标、手柄、触摸屏输入检测。
• 音频系统：加载和播放 WAV、OGG、MP3、FLAC 等格式的音效与音乐流。
• 2D 摄像机 / 3D 摄像机：内置第一人称、第三人称、轨道摄像机模式。
• 着色器支持：可以直接加载和使用自定义 GLSL 着色器，做后处理特效。
• 物理与碰撞检测辅助函数：矩形、圆形、射线的碰撞检测工具函数。
• 文件与内存管理工具：跨平台的文件读写、图像/纹理格式转换。
• 绑定生态丰富：官方及社区维护了 Go、Rust、Python、Odin、Zig、C#、Nim 等数十种语言的绑定。

raylib 内部大致分为几个相对独立又互相协作的模块：

1. core 模块：窗口创建、事件循环驱动、输入检测、时间管理，是整个库的入口层。
2. rlgl（渲染抽象层）：把 OpenGL 不同版本（1.1/2.1/3.3/ES2）的差异统一封装成一套一致的即时渲染风格 API，上层的 shapes、textures、models 模块都在此基础上构建。
3. shapes / textures / text 模块：分别负责基础图形绘制、纹理与图像处理、字体与文字渲染。
4. models 模块：3D 模型加载、骨骼动画、材质与光照的基础支持。
5. audio 模块（raudio）：基于 miniaudio 库封装的跨平台音频播放引擎，独立于图形渲染管线。
6. raymath：一个纯头文件的数学库，提供向量、矩阵、四元数运算，是 3D 场景计算的基础工具。

raylib 采用典型的"即时模式"（immediate mode）绘制风格：每一帧你都要在 BeginDrawing()/EndDrawing() 之间重新描述这一帧要画什么，没有保留模式下的场景图或渲染树，这也是它代码直观、易于理解的原因之一。

四、快速上手1. 安装

# Ubuntu/Debian 源码编译安装git clone https://github.com/raysan5/raylib.gitcd raylib/srcmake PLATFORM=PLATFORM_DESKTOPsudo make install# 编译时链接gcc main.c -lraylib -lGL -lm -lpthread -ldl -lrt -lX11 -o main

#include "raylib.h"int main() {InitWindow(800, 450, "raylib 入门示例");SetTargetFPS(60);while (!WindowShouldClose()) {BeginDrawing();ClearBackground(RAYWHITE);DrawText("Hello, raylib!", 190, 200, 20, DARKGRAY);EndDrawing();CloseWindow();return 0;

#include "raylib.h"int main() {InitWindow(800, 450, "移动的圆");SetTargetFPS(60);Vector2 ballPos = {400, 225};Vector2 ballSpeed = {5.0f, 4.0f};float ballRadius = 20;while (!WindowShouldClose()) {ballPos.x += ballSpeed.x;ballPos.y += ballSpeed.y;if (ballPos.x + ballRadius > GetScreenWidth() || ballPos.x - ballRadius < 0)ballSpeed.x *= -1;if (ballPos.y + ballRadius > GetScreenHeight() || ballPos.y - ballRadius < 0)ballSpeed.y *= -1;BeginDrawing();ClearBackground(RAYWHITE);DrawCircleV(ballPos, ballRadius, MAROON);EndDrawing();CloseWindow();return 0;

#include "raylib.h"int main() {InitWindow(800, 450, "键盘控制");SetTargetFPS(60);Vector2 pos = {400, 225};float speed = 4.0f;while (!WindowShouldClose()) {if (IsKeyDown(KEY_RIGHT)) pos.x += speed;if (IsKeyDown(KEY_LEFT))  pos.x -= speed;if (IsKeyDown(KEY_DOWN))  pos.y += speed;if (IsKeyDown(KEY_UP))    pos.y -= speed;BeginDrawing();ClearBackground(RAYWHITE);DrawRectangleV(pos, (Vector2){40, 40}, BLUE);DrawText("方向键移动方块", 10, 10, 20, DARKGRAY);EndDrawing();CloseWindow();return 0;

#include "raylib.h"int main() {InitWindow(800, 450, "纹理示例");Texture2D texture = LoadTexture("resources/player.png");SetTargetFPS(60);while (!WindowShouldClose()) {BeginDrawing();ClearBackground(RAYWHITE);DrawTexture(texture, 350, 175, WHITE);EndDrawing();UnloadTexture(texture);CloseWindow();return 0;

#include "raylib.h"int main() {InitWindow(800, 450, "3D 场景");Camera3D camera = { 0 };camera.position = (Vector3){10.0f, 10.0f, 10.0f};camera.target = (Vector3){0.0f, 0.0f, 0.0f};camera.up = (Vector3){0.0f, 1.0f, 0.0f};camera.fovy = 45.0f;camera.projection = CAMERA_PERSPECTIVE;SetTargetFPS(60);while (!WindowShouldClose()) {UpdateCamera(&camera, CAMERA_ORBITAL);BeginDrawing();ClearBackground(RAYWHITE);BeginMode3D(camera);DrawCube((Vector3){0, 0, 0}, 2.0f, 2.0f, 2.0f, RED);DrawGrid(10, 1.0f);EndMode3D();EndDrawing();CloseWindow();return 0;

#include "raylib.h"int main() {InitWindow(400, 200, "音效示例");InitAudioDevice();Sound fx = LoadSound("resources/jump.wav");SetTargetFPS(60);while (!WindowShouldClose()) {if (IsKeyPressed(KEY_SPACE)) PlaySound(fx);BeginDrawing();ClearBackground(RAYWHITE);DrawText("按空格播放音效", 60, 90, 20, DARKGRAY);EndDrawing();UnloadSound(fx);CloseAudioDevice();CloseWindow();return 0;

• 游戏编程教学：大量高校课程、YouTube 教程、Game Jam 训练营用 raylib 作为入门语言的第一个图形库，因为它把复杂度隐藏得恰到好处。
• 独立游戏开发（Indie Game）：2D 平台跳跃、俯视角 RPG、街机风格小游戏，用 raylib 从原型到成品都能胜任。
• Game Jam 快速原型：Ludum Dare、GMTK Game Jam 上有相当比例的 C/C++ 参赛作品选用 raylib，因为搭建速度快。
• 可视化与创意编程（Creative Coding）：图形算法演示、数据可视化小工具、粒子特效实验。
• 嵌入式与树莓派图形界面：在资源有限的设备上做轻量图形化交互界面。
• 跨平台工具类应用：借助 rGuiIcons、raygui 等官方衍生库，也可以做简易的桌面工具软件界面。

raylib 由 Ramon Santamaria（网名 raysan5）主导开发，是 GitHub 上星标数最高的游戏开发库之一，社区活跃度极高，官方 Discord 服务器汇聚了大量教学资源和答疑。围绕核心库衍生出一个完整生态：raygui（即时模式 GUI 控件库）、raymath（数学库）、rres（资源打包格式）、physac（简易 2D 物理引擎）等官方配套项目，此外社区还维护了针对几十种语言的绑定（如 Go 的 raylib-go、Rust 的 raylib-rs、C# 的 Raylib-cs），几乎可以说"你用什么语言都能用上 raylib"。raylib 官网提供了极其丰富的官方示例代码库（examples），按模块分类，是学习每个 API 用法最好的第一手资料。项目遵循 zlib 许可证，商业使用几乎没有限制。

七、总结

raylib 用近乎"反框架"的克制设计哲学，证明了 C 语言做游戏开发依然可以既简单又高效。它把窗口管理、渲染、输入、音频这些基础设施打包成一套一致、可预测的 API，让开发者可以把精力放在游戏逻辑本身。无论你是想教人写第一个游戏，还是想在 Game Jam 上快速验证一个创意，抑或只是想找一个轻量的跨平台图形库做可视化实验，raylib 都是 C 生态里值得放进工具箱的选择。