Debra Resnicoff说到raylib的常用函数，很多朋友第一反应是“这库除了画几个方块还能干嘛”。我最早也这么想，直到用它在48小时游戏开发挑战里完整做完了一个小游戏，才发现这套API设计得有多顺手。raylib是一个开源的、跨平台的C语言游戏编程库，核心定位就是让不懂图形学底层的人也能快速上手画窗口、处理输入、加载纹理和播放音频。它的优势在于函数命名极其直白、依赖极简、编译产物很小，适合初学者入门图形编程，也适合独立开发者做游戏原型验证。我个人用它写过一个节奏类小原型、一个拼图Demo，还给学生的课程设计做过几个可视化小工具，体验都相当不错。
这篇文章我打算把raylib里真正高频使用的那批常用函数从头到尾梳理一遍，包括窗口管理、绘制、输入、数学工具、资源管理以及常见的坑。每个函数我会尽量讲清楚“它解决什么问题”“为什么这么用”“实际项目中有什么注意点”，而不是简单贴一份API清单。适合刚接触raylib的初学者，也适合用过一阵子但想查漏补缺的朋友。
1. raylib是什么，为什么值得单独写一篇函数梳理
1.1 定位与核心优势
raylib最早是作为教学库被设计出来的，目标用户是那些想学游戏编程但不想一上来就碰OpenGL、DirectX的人。它用C语言编写，同时支持C++直接调用，内部封装好了窗口系统、OpenGL渲染、音频播放、输入采集和数学工具，你只要链上静态库就能跑。
对比一下其他方案，差异就很明显了。SDL2功能强大生态全，但API设计偏底层，窗口事件、渲染器、纹理管理都要花时间理清关系。SFML用C++封装，代码写起来舒服，但环境配置和跨平台编译相比raylib要重一些。GLFW加OpenGL的组合杀伤力在于控制力，但对新手来说光是把三角形画到屏幕就得写几百行样板代码。raylib的价值就是把这些复杂度全部吃掉，你调用InitWindow(800, 450, "Hello")，窗口就出来了；调用DrawCircle(screenWidth/2, screenHeight/2, 50, RED)，圆就画上去了。
它也有明显的短板，比如默认字体只有ASCII字符集、内置UI控件很少、3D能力只覆盖基础网格和模型。但这不影响它在快速原型、编程教学、游戏jam、小型工具场景里的实用性。我见过有人用raylib写MIDI可视化工具，有人用它做数据结构的动画演示，还有人拿它做键盘敲击检测的小程序，这些恰好都是SDL或Unity“杀鸡用牛刀”的场景。
1.2 整体函数体系与最小编程流程
raylib的函数命名有很强的规律，基本都是动词开头：
Init/Close负责初始化和清理Draw开头的都是绘制相关Load/Unload管理资源生命周期Is开头的返回布尔状态Get开头的获取当前数据
一套函数的调用顺序也有讲究。拿一个最基础的窗口程序举例：
c复制#include "raylib.h"
int main(void)
{
InitWindow(800, 450, "raylib 常用函数演示");
SetTargetFPS(60);
while (!WindowShouldClose())
{
BeginDrawing();
ClearBackground(RAYWHITE);
DrawText("Hello, raylib!", 190, 200, 20, LIGHTGRAY);
EndDrawing();
}
CloseWindow();
return 0;
}
InitWindow创建窗口，while (!WindowShouldClose())是主循环，BeginDrawing和EndDrawing之间放所有绘制指令，CloseWindow退出前清理。这个骨架覆盖了raylib八成以上项目的核心流程。你后面学到的所有函数，本质上都是往这个骨架里的某个缝隙塞进去。
需要模型API调用？ 免费领10W Token，多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. 窗口管理与游戏主循环：所有raylib程序的骨架
2.1 InitWindow、SetTargetFPS 与 WindowShouldClose
InitWindow(int width, int height, const char *title)是第一个要调用的函数，必须在任何绘制、加载资源之前执行。它的作用是创建窗口并初始化OpenGL上下文，前两个参数是窗口逻辑尺寸，第三个参数是标题。这里说的“逻辑尺寸”很重要，因为它和你屏幕的实际分辨率无关，raylib内部会做坐标系映射，哪怕窗口拉大拉小，你代码里写的坐标始终以初始化时设置的大小为基准。
SetTargetFPS(int fps)设置目标帧率。很多人以为它只是限制刷新率，实际它还控制逻辑更新的频率。比如你跑一个模拟器，设定60帧，那么主循环每秒最多迭代60次。如果把它设为0或者不调用，程序会以最快速度跑循环，CPU占用高不说，游戏逻辑也会变得不可控。稳妥做法是开发阶段设60，发布时再根据目标平台调。
WindowShouldClose()返回值是主循环的退出条件。它内部会检测用户是否点击了窗口关闭按钮、是否按下了ESC键（默认为退出键）、窗口是否被系统销毁。返回true时主循环退出，程序走到清理阶段。大部分教程里这个函数都写得很轻描淡写，但实际项目里你几乎总需要在它返回true之前做保存。我自己的习惯是在循环头部判断一次，如果需要保存存档就先保存再退出。
BeginDrawing()和EndDrawing()是一对强制性函数，所有绘制操作必须放在这对调用之间。BeginDrawing会锁定渲染缓冲，EndDrawing会将缓冲切换到屏幕，同时清理内部绘制状态。漏写任何一个，常见的表现就是窗口黑屏或者偶发崩溃。
2.2 窗口管理常见坑位与处理技巧
窗口这块我踩过的坑有几个值得单独说。
第一个是CloseWindow()被漏掉。程序退出时操作系统会回收资源，所以漏写通常不会导致严重问题，但如果你在同一个进程里反复创建销毁窗口（比如做了个窗口管理工具），资源泄漏就比较明显了。
第二个是`S