2、开发环境搭建：Windows/Linux/macOS下的开发环境配置、CMake工程搭建、GLFW/GLAD库集成

说实话，图形API开发的第一步往往不是写代码，而是搞定环境。我见过太多新手卡在这一步，明明代码逻辑没问题，编译却报一堆莫名其妙的错。嗯，今天我们就来把这层窗户纸捅破。

2.1 操作系统级准备

先说说三个主流平台。我个人习惯在Windows上做原型开发，Linux上做性能调优，macOS嘛…说实话，Metal才是亲儿子，但OpenGL/Vulkan也能跑。

Windows

• 编译器：Visual Studio 2022 Community（免费，装的时候勾上「使用C++的桌面开发」）
• CMake：官网下载最新版，安装时记得勾选「Add CMake to system PATH」
• Git：用于拉取GLFW/GLAD源码，装个Git Bash方便些

Linux

• 编译器：GCC/G++（sudo apt install build-essential）
• CMake：sudo apt install cmake
• 依赖库：sudo apt install libxrandr-dev libxinerama-dev libxcursor-dev libxi-dev

为什么需要这些X11开发库？因为GLFW在Linux下依赖X11窗口系统。你想想看，没有这些头文件，GLFW连个窗口都创建不了。

macOS

• 编译器：Xcode Command Line Tools（xcode-select --install）
• CMake：brew install cmake 或者官网下载dmg
• 注意：macOS默认用Clang，别装GCC了，容易出兼容问题

2.2 CMake工程搭建

CMake这东西，说白了就是一套「生成构建系统」的工具。你写一份CMakeLists.txt，它帮你生成VS项目、Makefile或者Xcode项目。我建议所有图形项目都用CMake，跨平台迁移时你就知道有多香了。

先看一个最简的CMakeLists.txt：

cmake_minimum_required(VERSION 3.20)
project(GraphicsApp)

set(CMAKE_CXX_STANDARD 17)
set(CMAKE_CXX_STANDARD_REQUIRED ON)

# 添加可执行文件
add_executable(${PROJECT_NAME} main.cpp)

# 链接OpenGL（不同平台不一样）
if(WIN32)
    target_link_libraries(${PROJECT_NAME} opengl32)
elseif(APPLE)
    find_library(COCOA_LIBRARY Cocoa)
    find_library(OPENGL_LIBRARY OpenGL)
    target_link_libraries(${PROJECT_NAME} ${COCOA_LIBRARY} ${OPENGL_LIBRARY})
else()
    target_link_libraries(${PROJECT_NAME} GL)
endif()

嗯，这里要注意：Windows下OpenGL是系统自带的opengl32.lib，Linux下是-lGL，macOS下是OpenGL.framework。别搞混了。

2.3 GLFW库集成

GLFW是什么？它帮你处理窗口创建、输入事件、OpenGL上下文。说白了，你不想自己写Win32或X11的窗口代码吧？那就用GLFW。

集成方式有两种：

1. 源码编译（推荐）：把GLFW源码放到项目里，CMake直接编译
2. 系统安装：apt install libglfw3-dev 或 brew install glfw

我个人习惯用源码编译，可控性更强。在项目根目录建个 third_party 文件夹，把GLFW源码放进去。然后在CMakeLists.txt里加：

# 添加GLFW子目录
add_subdirectory(third_party/glfw)

# 链接GLFW
target_link_libraries(${PROJECT_NAME} glfw)

# 别忘了GLFW需要的一些系统库
if(WIN32)
    target_link_libraries(${PROJECT_NAME} gdi32)
elseif(APPLE)
    # macOS下GLFW会自动链接Cocoa和IOKit
else()
    target_link_libraries(${PROJECT_NAME} dl pthread)
endif()

2.4 GLAD库集成

GLAD是OpenGL的加载库。为什么需要它？因为OpenGL是规范，具体实现由显卡驱动提供。GLAD帮你动态加载这些函数指针。没有它，你连glGenBuffers都调不了。

GLAD的使用方式：

1. 访问 https://glad.dav1d.de/
2. API选择OpenGL 4.6（或你需要的版本）
3. Profile选Core（核心模式）
4. 勾选「Generate a loader」
5. 点击生成，下载zip包

把生成的 glad.c 和 include 文件夹放到项目里。CMake里这样加：

# 添加GLAD源文件
add_library(glad STATIC third_party/glad/src/glad.c)
target_include_directories(glad PUBLIC third_party/glad/include)

# 链接到主项目
target_link_libraries(${PROJECT_NAME} glad)

2.5 完整工程结构

来看一个我常用的项目布局：

GraphicsApp/
├── CMakeLists.txt
├── main.cpp
├── third_party/
│   ├── glfw/          # GLFW源码
│   └── glad/          # GLAD源码和头文件
│       ├── src/
│       │   └── glad.c
│       └── include/
│           ├── glad/
│           │   └── glad.h
│           └── KHR/
│               └── khrplatform.h
└── build/             # 构建目录（gitignore掉）

对应的完整CMakeLists.txt：

cmake_minimum_required(VERSION 3.20)
project(GraphicsApp)

set(CMAKE_CXX_STANDARD 17)
set(CMAKE_CXX_STANDARD_REQUIRED ON)

# GLFW
add_subdirectory(third_party/glfw)

# GLAD
add_library(glad STATIC third_party/glad/src/glad.c)
target_include_directories(glad PUBLIC third_party/glad/include)

# 主程序
add_executable(${PROJECT_NAME} main.cpp)
target_link_libraries(${PROJECT_NAME} glfw glad)

# 平台相关链接
if(WIN32)
    target_link_libraries(${PROJECT_NAME} opengl32 gdi32)
elseif(APPLE)
    find_library(COCOA_LIBRARY Cocoa)
    find_library(OPENGL_LIBRARY OpenGL)
    target_link_libraries(${PROJECT_NAME} ${COCOA_LIBRARY} ${OPENGL_LIBRARY})
else()
    target_link_libraries(${PROJECT_NAME} GL dl pthread)
endif()

2.6 验证环境

写个简单的main.cpp测试一下：

#include <glad/glad.h>
#include <GLFW/glfw3.h>
#include <iostream>

int main() {
    // 初始化GLFW
    if (!glfwInit()) {
        std::cerr << "GLFW初始化失败" << std::endl;
        return -1;
    }

    // 创建窗口
    GLFWwindow* window = glfwCreateWindow(800, 600, "Hello Graphics", nullptr, nullptr);
    if (!window) {
        std::cerr << "窗口创建失败" << std::endl;
        glfwTerminate();
        return -1;
    }

    glfwMakeContextCurrent(window);

    // 加载OpenGL函数
    if (!gladLoadGLLoader((GLADloadproc)glfwGetProcAddress)) {
        std::cerr << "GLAD加载失败" << std::endl;
        return -1;
    }

    std::cout << "OpenGL版本: " << glGetString(GL_VERSION) << std::endl;

    // 主循环
    while (!glfwWindowShouldClose(window)) {
        glClear(GL_COLOR_BUFFER_BIT);
        glfwSwapBuffers(window);
        glfwPollEvents();
    }

    glfwDestroyWindow(window);
    glfwTerminate();
    return 0;
}

编译运行：

cd build
cmake ..
cmake --build .
./GraphicsApp

如果看到一个800x600的黑色窗口，恭喜你，环境搭好了！

---