raylib 快速入门指南：从一份 C 文件到你的第一个 2D/3D 游戏-编程实验室

raylib 快速入门指南：从一份 C 文件到你的第一个 2D/3D 游戏

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

想做一款小游戏，却不想先啃下几个 G 的引擎？raylib 就是一个为你准备的 C 语言图形编程库：画形状、转模型、放音乐，十几行代码就能跑起来，让你把精力花在玩法本身，而不是环境配置上。

raylib 是什么：一个让你专注玩法的图形库

一句话概括：raylib 是一个简单、易用的游戏编程库，帮你跳过图形 API 的繁琐细节，直接上手开发 2D/3D 应用。

它特别适合这类人：

会一点 C 语言，想快速看到「画面动起来」的反馈
想学游戏开发，但觉得大型引擎太重、学习曲线太陡
做工具、做演示、做小游戏，只想要一个轻量可靠的底层

装上之后你拿到的不是半个引擎，而是一整套基础能力：窗口、绘图、模型、纹理、音频、输入，全都开箱即用。

最快配置方式：克隆仓库并用 CMake 构建

先拿到源码（仓库地址只在这里出现一次，clone 完就不用了）：

git clone https://gitcode.com/GitHub_Trending/ra/raylib cd raylib

接着用 CMake 构建库文件。如果你不熟悉 CMake，记住「进目录、建 build、两步走」就够了：

mkdir build && cd build cmake .. make

看到编译成功的输出，说明库已经就绪。这一步如果卡住很正常，多试几次make，或者翻一下根目录的 README.md 里对应平台的说明。

到这里，环境部分就全部搞定了。

跑通第一版：一个会画文字的小窗口

新建一个main.c，内容只要下面这一小段：

#include "raylib.h" int main(void) { InitWindow(800, 450, "My First Raylib Window"); SetTargetFPS(60); while (!WindowShouldClose()) { BeginDrawing(); ClearBackground(RAYWHITE); DrawText("Hello, raylib!", 320, 200, 20, LIGHTGRAY); EndDrawing(); } CloseWindow(); return 0; }

这段代码做了三件小事，每件都对应一个「为什么」：

InitWindow创建 800x450 的窗口，是程序的入口
while循环就是游戏的「心跳」，每一帧大约 16 毫秒
BeginDrawing和EndDrawing之间，放你这帧想画的所有东西

编译运行后，你会看到这样一扇属于自己的小窗：

恭喜，到这里你已经跑通了第一版。后面所有花哨功能，都是在这个骨架上「往循环里加东西」。

raylib 能做什么：挑三样最能打的给你看

一行一个图元：2D 图形随手画

2D 部分是 raylib 最直观的亮点。圆形、矩形、三角形、多边形……每个图形基本就是一行函数调用，颜色、透明度、渐变都直接传参数：

写个弹球、画个小迷宫、做弹幕小游戏，靠的就是这些「积木块」的排列组合。

加载并旋转 3D 模型：从纸片到立体

想上 3D？LoadModel读入模型文件，配上一个相机，再在循环里给模型加一点旋转，一个可交互的三维场景就立起来了。下面这个「城堡」就是官方示例的效果，还能拖拽查看：

贴图、光照、骨骼动画也都内置了，不用自己碰底层的图形 API。

音乐与音效：顺手连上输入处理

音频这边支持 WAV、OGG、MP3 等常见格式，加载后一行PlaySound就能出声。

注意这个示例是「按空格/回车」触发的——说明输入处理同样轻量：键盘按键、鼠标移动、手柄按键，都是几个简单的判断函数，写交互逻辑非常省心。

学完之后往哪走：examples 就是免费的私教课

raylib 仓库本身就是最好的教材，几个入口先收藏：

examples/：几百个官方示例，按 core、shapes、models、textures、audio、shaders 分门别类，每个都能直接编译运行，照着抄就能学会
README.md：完整的功能列表与编译说明
src/：核心源码，配合 src/raylib.h 可以精读每个 API 的实现
tools/：辅助工具，比如 rlparser 可以把 API 解析成多种格式
projects/：各 IDE 的项目模板（VS2022、CMake、CodeBlocks 等），拿来即用