raylib常用函数全解析：从窗口管理到资源生命周期的实战指南-代码聚汇网

raylib常用函数全解析：从窗口管理到资源生命周期的实战指南

Debra Resnicoff·2026-09-14·阅读 22 GEO检测（免费）

raylib常用函数游戏开发

|难度：普通|阅读约 42 分钟

说到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()被漏掉。程序退出时操作系统会回收资源，所以漏写通常不会导致严重问题，但如果你在同一个进程里反复创建销毁窗口（比如做了个窗口管理工具），资源泄漏就比较明显了。

第二个是SetTargetFPS(0)的用法。这个不是错误，而是等价于不限制帧率。你如果做的是循环动画性能测试，可以临时用它放开帧率，但在正式游戏里请不要这么做。

第三个是默认按ESC退出。raylib把ESC设为默认退出键，很多做游戏的人第一次运行时按了ESC直接退出了，还以为是程序崩溃。用SetExitKey(KEY_NULL)可以关掉这个默认行为，把退出逻辑完全交给WindowShouldClose和你的自定义按键处理。

第四个坑是突然一闪而过。新手最常见的报错是“窗口刚弹出来就没了”，十有八九是没写主循环，或者把循环写成了while (true)导致看起来“转圈”后又退出。只要把WindowShouldClose()作为循环条件，窗口就会一直挂着。

3. 绘制函数：把图像、文字和几何体画到屏幕上

3.1 几何形状绘制：矩形、圆形、线条与多边形

raylib的绘制函数分成几个族群，最常用的是形状绘制。

DrawRectangle(int posX, int posY, int width, int height, Color color)画矩形，前两个参数是左上角坐标，后两个是宽度和高度。很多人第一次用会把它理解成“中心点坐标+半径”，然后发现矩形的位置偏了。这是raylib和很多UI库的差异，它的矩形锚点在左上角，而圆形锚点在圆心。

DrawRectangleV(Vector2 position, Vector2 size, Color color)是把位置和尺寸换成Vector2参数，适合在代码里用向量计算时更自然的写法。DrawRectangleRec(Rectangle rec, Color color)则接收一个Rectangle结构体，这个结构体在raylib里大量用于碰撞检测和精灵裁剪，把绘制和碰撞统一用同一个矩形描述，能少维护一套数据。

DrawRectangleRounded(Rectangle rec, float roundness, int segments, Color color)画圆角矩形，roundness取值0到1，0是尖角，1是两端半圆。segments控制圆角部分的分段数，数值太小圆角会显露出多边形棱角，太大又浪费性能，实际项目里给8到16就够。

圆形方面，DrawCircle(int centerX, int centerY, float radius, Color color)是基础款。它还有两个高频变体：DrawCircleV(Vector2 center, float radius, Color color)用于圆心坐标是向量的场景，DrawCircleSector(Vector2 center, float radius, float startAngle, float endAngle, int segments, Color color)可以画扇形。画扇形在做血条、技能冷却转圈时很好用。

线条方面，DrawLine(int startPosX, int startPosY, int endPosX, int endPosY, Color color)画最细的1像素线，但1像素线在游戏中经常看不清，所以实际更常用的反而是DrawLineEx(Vector2 startPos, Vector2 endPos, float thick, Color color)，它可以指定线宽。画网格、瞄准辅助线、曲线图都用它。

三角形用DrawTriangle(Vector2 v1, Vector2 v2, Vector2 v3, Color color)，只需要三个顶点坐标。如果只想画边框就用DrawTriangleLines。DrawPoly(Vector2 center, int sides, float radius, float rotation, Color color)可以画任意正多边形，sides填3是三角形，填6是六边形，旋转角度从0开始顺时针计算。这个函数在做多边形特效和齿轮图案时特别方便。

最后是DrawPixel(int posX, int posY, Color color)，单独画一个像素点。它在做雷达扫描、噪声纹理预览、最小尺度调试的时候有用，但正常游戏里几乎不用它来渲染内容，性能太低了。

3.2 文字绘制与字体加载

DrawText(const char *text, int posX, int posY, int fontSize, Color color)是最基础的文字绘制函数。它用的是raylib内置的默认字体，字号参数fontSize理解为“高度”更准确，不是像素宽度。要测量一段文字的宽度以便居中，用MeasureText(const char *text, int fontSize)，它返回像素宽度。

默认字体有个巨大的限制：只包含ASCII字符集。也就是说，你直接画中文、日文、表情符号，出来的都是“方块”或者空白。这不是你代码写错，而是字体纹理里根本没有对应字形。解决方法是加载外部字体：

c复制Font font = LoadFontEx("assets/font.ttf", 64, 0, 0);
DrawTextEx(font, "中文测试", (Vector2){ 100, 100 }, 32, 2, BLACK);

LoadFontEx的第一个参数是字体文件路径，第二个参数是基础字号，后面两个参数和字体字符集有关，用到0就行。加载完的Font对象配合DrawTextEx使用，可以在绘制时指定位置、字号、字符间距和行间距，比基础DrawText灵活得多。字体文件体积不小，所以大项目一般会做子集化，只保留用到的字符。

3.3 纹理绘制与常用变体

纹理是游戏中最重要的资源类型。Texture2D tex = LoadTexture("assets/player.png")加载一张图片，返回的Texture2D结构体里包含GPU纹理ID、宽高等信息。

绘制纹理有几个层次：

c复制DrawTexture(tex, x, y, WHITE);
DrawTextureEx(tex, (Vector2){ x, y }, rotation, scale, WHITE);
DrawTexturePro(tex, sourceRec, destRec, (Vector2){ 0, 0 }, rotation, WHITE);

DrawTexture最简单，把纹理左上角放到指定坐标，最后一个参数是色调叠加，填WHITE表示原样绘制。DrawTextureEx多了旋转角度和缩放系数，适合做旋转物体、粒子特效。DrawTexturePro是功能最全的，sourceRec指定原图上截取哪块区域，destRec指定绘制到屏幕上的哪块矩形，origin是旋转中心点。它最大的用途是精灵动画：把一张精灵图集按帧切成小块，逐帧改变sourceRec即可播放动画。

一个容易被忽略的点是纹理的锚点。raylib的DrawTextureEx默认以纹理左上角为基准点旋转和缩放，想要以中心点旋转就得先算出偏移量，或者用DrawTexturePro把origin设成纹理宽高的一半。

绘制顺序也值得念叨一下。raylib在BeginDrawing和EndDrawing之间接收所有绘制指令，实际渲染在EndDrawing时统一提交。所以屏幕上元素的层级关系就是你代码里调用的先后顺序：后绘制的会覆盖先绘制的。做场景管理时，一般先画背景、再画地图、再画角色、最后画UI，顺序不要乱。

4. 输入处理：键盘、鼠标、手柄与触摸

4.1 理解“按下”和“按住”的区别

raylib的键盘输入函数是新手最容易搞混的一块，核心在于区分IsKeyDown和IsKeyPressed。

IsKeyDown(int key)表示键盘当前状态是“按住”，只要键没松开，每一帧它都返回true。它适合持续性动作，比如按住方向键移动角色、按住加速键跑步。

IsKeyPressed(int key)表示“这一帧刚被按下”，也就是说，同一个键按住不动，它只在你按下的第一帧返回true，之后就算键还按着，它也返回false。它适合单次触发动作，比如跳跃、射击、暂停。

我见过很多人把这两个混用，结果按一下空格角色连续跳了好几次。原因就是Jump写在IsKeyDown里，只要角色还在地上，按住空格期间每帧都在跳。判断时机上，该用哪个函数的直觉是：这个动作需要持续执行吗？如果需要，用IsKeyDown；如果只需要触发一次，用IsKeyPressed。

4.2 GetKeyPressed 与文本输入

int GetKeyPressed(void)返回当前帧读取到的按键字符对应的ASCII码，但它和IsKeyPressed不是一回事。GetKeyPressed更底层一些，它把键盘上按下的字母数字键逐个返回而不是只返回“按下状态”，常用于文本输入框。做输入框时配合GetCharPressed()处理字符输入、配合IsKeyPressed(KEY_BACKSPACE)处理删除，得到的效果才接近真实输入框行为。

4.3 鼠标输入与触摸输入的合并设计

鼠标部分的函数同样分成IsMouseButtonDown和IsMouseButtonPressed，逻辑与键盘一致，参数分别是MOUSE_BUTTON_LEFT、MOUSE_BUTTON_RIGHT、MOUSE_BUTTON_MIDDLE。

获取坐标：

c复制Vector2 mouse = GetMousePosition();

鼠标位置是屏幕坐标，原点在左上角，x向右增大，y向下增大，和很多图形库一致。GetMouseDelta()返回鼠标相对上一帧的位移，适合做第一人称视角旋转，它不受窗口位置影响，直接给增量，省去手动计算差值。

raylib另一处贴心设计是鼠标和触摸接口合并。在PC上是鼠标点击，在触屏上是手指点击，代码不用改就能适配。GetTouchPosition(int index)可获取第index根手指的位置，在移动端调试时特别方便。

4.4 游戏手柄与自定义退出键

手柄相关API也很完整，IsGamepadAvailable(int gamepad)检测手柄是否存在，GetGamepadAxisMovement(int gamepad, int axis)读取摇杆轴数据，IsGamepadButtonPressed(int gamepad, int button)检测按键事件。实际开发中手柄输入很少单独直接用，通常会封装一层统一的“输入管理器”，把键盘、鼠标、手柄映射成游戏内的“跳跃”“移动”“开火”等抽象指令。

最后还是要提一句SetExitKey(KEY_NULL)。如果不调用它，按下ESC程序直接退出。在正式游戏里这体验很差，玩家只是想呼出菜单，结果整个进程没了。所以启动阶段就把它禁掉，再把退出逻辑收拢到你自己的状态机里。

5. 数学与工具函数：向量、插值、碰撞与帧率无关移动

5.1 Vector2 与常用向量操作

raylib内置了Vector2、Vector3、Rectangle、Color这几个基础结构体，还配了一套小巧的数学函数。这些函数不求覆盖全面的线性代数，但游戏开发里最常用到的那些都给了。

Vector2Add(Vector2 a, Vector2 b)和Vector2Subtract(Vector2 a, Vector2 b)是向量加减法，Vector2Scale(Vector2 v, float scale)是向量缩放。它们最常见的用途是移动计算：把速度向量加到位移向量上，再用缩放控制快慢。

Vector2Length(Vector2 v)返回向量长度，Vector2Normalize(Vector2 v)返回单位向量。这两个函数做方向计算、速度归一化时很常用，比如敌人朝玩家方向移动，先算出方向向量，再归一化后乘以速度。

Vector2Distance(Vector2 v1, Vector2 v2)返回两点间距离。它内部就是一次向量减法再加一次Vector2Length，但直接调用语义更清晰，也少写代码。

5.2 Clamp、Lerp 与平滑跟随的写法

float Clamp(float value, float min, float max)把数值限制在指定范围，做角色位移边界、血条百分比、音量控制都最常见。举个例子，玩家坐标x算出后要保证不出屏幕：

c复制player.x = Clamp(player.x, 0, screenWidth - playerWidth);

float Lerp(float start, float end, float amount)做线性插值，amount取值范围0到1，0返回start，1返回end。Vector2Lerp(Vector2 start, Vector2 end, float amount)是向量版本。

Lerp在“平滑跟随”场景中特别好用。比如让一个准星徐徐移向鼠标位置：

c复制Vector2 mouse = GetMousePosition();
Vector2 smoothPos = Vector2Lerp(currentPos, mouse, 0.08f * GetFrameTime() * 60.0f);

这里的0.08f * GetFrameTime() * 60.0f意思是以60帧为基准的插值系数，让不同帧率下跟随速度保持一致。直接写死0.08f在60帧下没问题，换成144帧屏幕就会过快，这种细节在正式项目里经常踩。

5.3 GetFrameTime 与帧率无关逻辑

float GetFrameTime(void)返回上一帧实际消耗的秒数，例如60帧运行下大约是0.016f。用它做运动计算，能让游戏逻辑与帧率无关。

错误写法：

c复制player.x += 5.0f; // 每帧固定加5

这个写法在60帧下角色每秒移动300像素，在144帧下每秒移动720像素，速度差了一倍多。正确写法：

c复制player.x += 300.0f * GetFrameTime(); // 每秒移动300像素

GetFrameTime的数值很小，乘上一个较大的速度值才符合直觉。另一个和时间相关的函数是double GetTime(void)，它返回程序启动以来经过的秒数，适合做倒计时、音乐节拍计算、缓动动画的时间基准。

5.4 随机数、FPS显示与碰撞检测

int GetRandomValue(int min, int max)返回闭区间[min, max]内的整数随机数。射线小球、随机生成地图、掉落物都靠它。

DrawFPS(int posX, int posY)把当前帧率画到屏幕上，是我开发时必开的调试工具。它虽然功能简单，但能直观反映性能变化，发布前记得删除或者用宏包起来。

碰撞检测方面，raylib提供了几个非常实用的函数：

CheckCollisionRecs(Rectangle rec1, Rectangle rec2)检测两个矩形是否相交
CheckCollisionCircleRec(Vector2 center, float radius, Rectangle rec)检测圆与矩形是否相交
CheckCollisionPointRec(Vector2 point, Rectangle rec)检测点是否在矩形内
CheckCollisionPointCircle(Vector2 point, Vector2 center, float radius)检测点是否在圆内

把这些碰撞函数和Rectangle结构体结合，做子弹命中、鼠标点击选中等需求几乎不需要自己算数学。

6. 资源管理：纹理、音频与字体的生命周期

6.1 加载与卸载的成对原则

raylib里所有Load开头的函数，理论上都要对应一个Unload函数。最典型的三对：

LoadTexture / UnloadTexture
LoadSound / UnloadSound
LoadFont / UnloadFont
InitAudioDevice / CloseAudioDevice
LoadMusicStream / UnloadMusicStream

这其实和C语言的malloc/free逻辑一样，谁申请谁释放。raylib内部没有自动垃圾回收，你加载的资源会占GPU显存或内存，不释放的话，反复切换场景时内存会越涨越高，最终卡顿甚至崩溃。

一个项目里资源管理做得好的标志是：Init阶段统一加载所有全局资源，场景切换时只处理场景级资源，程序退出时统一卸载。我自己习惯用一个小结构体集中管理：

c复制typedef struct GameAssets {
    Texture2D playerTex;
    Texture2D enemyTex;
    Sound shootSfx;
    Font uiFont;
} GameAssets;

加载一次，全局共享，退出时按顺序Unload，事半功倍。

6.2 加载失败与路径问题

纹理加载显示出来全黑，是raylib里出现频率极高的问题。核心原因就两个：路径不对，或者图片格式不支持。

raylib的路径是相对“当前工作目录”而不是可执行文件所在目录。在调试器里运行时，工作目录往往是项目根目录；双击exe运行时，工作目录是exe所在目录。如果你把assets文件夹放在项目根目录下，但从别处直接运行exe，就会找不到纹理。

排查方法很直接，用4.5版本后新增的Ready系列函数：

c复制Texture2D tex = LoadTexture("assets/player.png");
if (!IsTextureReady(tex)) {
    TraceLog(LOG_WARNING, "Failed to load: %s", "assets/player.png");
}

IsTextureReady返回false说明加载失败。这时候优先检查文件是否存在、路径是否大小写一致、图片格式是否为png或jpg。bmp这类老格式在某些环境解码有问题，尽量避免。

6.3 音频模块的使用要点

音频模块有一个必须记住的顺序：先InitAudioDevice()，再加载声音文件。

c复制InitAudioDevice();
Sound shot = LoadSound("assets/shot.wav");
PlaySound(shot);

InitAudioDevice初始化默认音频设备，不调用它的话，LoadSound可能不报错，但PlaySound没有任何声音输出。这个坑我见过不少人白折腾半天。

背景音乐和音效不同，它不是一次性播放完，而是持续播放的流式数据，所以每帧都要调用UpdateMusicStream(Music music)，否则音乐会停在一开始不前进。典型配合：

c复制Music bgm = LoadMusicStream("assets/bgm.ogg");
PlayMusicStream(bgm);

while (!WindowShouldClose()) {
    UpdateMusicStream(bgm);
    // 其他逻辑
}

音量设置用SetSoundVolume(Sound sound, float volume)和SetMusicVolume(Music music, float volume)，范围都是0到1。0是静音，1是原始音量，可以以此实现淡入淡出效果。程序退出前调CloseAudioDevice()，否则音频线程可能会遗留。

7. 常见问题与排查技巧实录

7.1 “无法将 X 项识别为 cmdlet、函数、脚本文件或可运行程序的名称”是环境配置问题

这个报错在raylib相关社群出现频率极高，但它和raylib本身没有直接关系。这个报错的原因是，你输入的gcc、git、make等命令对应的可执行文件没有安装，或者装了但不在系统PATH环境变量里。Windows PowerShell执行命令时会在当前目录和PATH中搜索，找不到就会抛出这样一段“无法将X项识别为cmdlet”的提示。

排查顺序：

确认是否安装了MinGW-w64或Visual Studio Build Tools；
在PowerShell里执行where gcc，能显示路径说明没问题，没显示就要补环境变量；
把MinGW的bin目录加到系统环境变量里，比如C:\mingw64\bin；
添加完变量后，重新打开终端再试，不要在一个旧终端里验证。

很多raylib教程直接用gcc main.c -lraylib编译，如果编译环节挂在这里，先检查环境配置，再看代码。

7.2 窗口一闪而过，怎么解决

窗口弹出了瞬间关闭，原因基本是主循环没有正确维持。代码必须满足这个结构：

c复制InitWindow(...);
while (!WindowShouldClose()) {
    // update
    // draw
}
CloseWindow();

如果你写了while (true)却没打破循环的出口，窗口倒是不会闪退，但永远退不出。正确做法是依赖WindowShouldClose()作为唯一的循环出口，用户点窗口关闭按钮后，它返回true才退出。

7.3 中文显示乱码或空白

默认字体只支持ASCII，画中文就乱码。解决方案是加载外部中文字体文件，用LoadFontEx配合DrawTextEx绘制。字体文件可以选思源黑体、文泉驿等开源字体，加载时把基础字号调大一些，按需绘制。

乱码问题还可以通过编辑器强制改成某种编码来解决的传言基本是无效的，因为raylib默认字模中根本没有中文字形，和源文件编码无关。

7.4 帧率相关的Bug

角色跑太快、动画不均匀这类问题，几乎都出在没使用GetFrameTime。把固定像素移动量改成“速度值乘以GetFrameTime”，问题就消失了。同样，所有需要平滑的数值变化，都尽量用插值加帧时间，效果可控性会好很多。

7.5 纹理显示全黑

先检查IsTextureReady，再确认路径和文件名大小写，再确认图片格式。最后再看是不是编译链接阶段资源打包方式的问题。raylib没有内置资源系统，所有资源都是运行时从文件系统加载的，所以发布目录里一定要包含assets文件夹。

7.6 常见问题速查表

现象	排查方向	解决思路
窗口一闪而过	主循环缺失	补 `while (!WindowShouldClose())`
中文显示乱码	默认字体不含中文	`LoadFontEx` 加载外部TTF
纹理黑块	加载失败或路径错误	`IsTextureReady` 检查后修正路径
角色速度不稳	未使用帧率无关逻辑	用 `GetFrameTime()` 换算
音频没声音	未初始化音频设备	先调用 `InitAudioDevice()`
无法识别gcc命令	环境变量PATH未配置	将MinGW/bin加入PATH
ESC退出游戏	默认退出键未禁用	调用 `SetExitKey(KEY_NULL)`

我实际做raylib项目时踩得最多的坑不是函数用法，而是资源路径和字体编码。raylib的函数设计已经足够直白，你读一遍API列表基本就能猜出八成行为，难的是把整个生命周期管好。轻量项目里函数随便写没问题，但项目一旦超过十个场景，建议就得上状态机管理模式，把Init、Load、Update、Draw、Unload分成明确的阶段。

最后分享一个小技巧：开发时在主界面右上角挂一个DrawFPS显示帧率，切窗口、调参、看性能都方便；发布时再把那行代码删掉。这个习惯帮我省了不少调试时间。raylib看起来简单，但它把OpenGL那层皮剥掉之后，反而能让人更专注在游戏逻辑本身上，我挺推荐新手从DrawCircle加IsKeyPressed做一个打砖块开始上手，跑通整套流程之后再往深处走。