本页目录
官方资料整理 Windows Linux macOS

raylib 开发与测试环境部署

在桌面平台配置 C/C++ 工具链与 raylib,编译并运行示例或现有 CMake/Makefile 项目。

适用项目: 引擎通用(暂未关联具体项目)

工具版本:raylib 5.x、CMake 3.20+、MSVC / MinGW / Clang

未标注「站长实测」的步骤请自行核验。

本篇为 raylib 通用环境教程。官方站点与示例见 raylib.com 与 GitHub examples。具体开源游戏可能用 CMake、Makefile 或预编译库,以仓库为准。

1. 准备 C/C++ 编译环境

  • Windows:安装 Visual Studio 2022(Desktop C++)或 w64devkit / MSYS2 MinGW。
  • Linux:build-essential、以及 libgl1-mesa-dev 等 OpenGL 相关开发包(发行版包名略有差异)。
  • macOS:安装 Xcode Command Line Tools。
  • 建议同时安装 CMake。

2. 获取 raylib

任选其一:

  1. 包管理:vcpkg / Homebrew / 发行版包装 raylib(版本可能滞后)。
  2. 源码:克隆 raysan5/raylib,按 wiki 用 CMake 安装到系统或本地前缀。
  3. 跟仓库走:许多游戏把 raylib 放在 third_party 或作为 submodule,此时不必系统安装。

3. 编译运行示例或目标项目

  1. 官方示例:进入 examples,按平台脚本或 CMake 目标编译 core_basic_window 等,确认弹出窗口。
  2. 开源游戏:阅读 README 的 build 段落,常见为:
cmake -B build -DCMAKE_BUILD_TYPE=Release
cmake --build build
  1. 链接错误(找不到 raylib / OpenGL / winmm):检查 CMAKE_PREFIX_PATH、库路径与系统依赖是否装全。