图形渲染与 Shader / 系统课时

搭建 C++ 开发环境

搭建 C++ 开发环境

本课从空目录搭建一个可构建、可运行的 OpenGL C++ 工程。最终项目使用 CMake 管理构建,使用 vcpkg 提供 GLFW 与 GLEW,并创建一个 OpenGL 3.3 核心模式窗口作为后续示例的统一起点。

学习目标

  • 准备支持 C++17 的编译器、CMake、Git 与 vcpkg
  • 建立清晰的跨平台项目目录和依赖声明
  • 编译并验证第一个 OpenGL 窗口程序

前置检查

Windows 可使用 Visual Studio 的“使用 C++ 的桌面开发”工作负载,macOS 安装 Xcode Command Line Tools,Linux 安装 GCC 或 Clang。无论使用哪套编译器,都应先确认 CMake 与 Git 可以在终端中执行。

bash
cmake --version
git --version

预期输出如下,具体版本号可能不同。

text
cmake version <VERSION>
git version <VERSION>

如果终端提示命令不存在,应先完成对应工具安装并重新打开终端。Windows 使用 MSVC 时,建议在 Developer PowerShell 中构建;macOS 和 Linux 可直接使用系统终端。

安装 vcpkg

vcpkg 用于统一安装 GLFW 与 GLEW,避免手工复制头文件和库文件。先选择一个长期保留的目录,并根据操作系统执行初始化。

macOS 或 Linux:

bash
export VCPKG_ROOT="$HOME/tools/vcpkg"
git clone https://github.com/microsoft/vcpkg.git "$VCPKG_ROOT"
"$VCPKG_ROOT/bootstrap-vcpkg.sh"

预期结果:

text
vcpkg package management program version <VERSION>

Windows PowerShell:

powershell
$env:VCPKG_ROOT = "$HOME\tools\vcpkg"
git clone https://github.com/microsoft/vcpkg.git $env:VCPKG_ROOT
& "$env:VCPKG_ROOT\bootstrap-vcpkg.bat"

预期结果:

text
vcpkg package management program version <VERSION>

VCPKG_ROOT 只在当前终端会话中生效。重新打开终端后需要再次设置,或者把它保存为用户环境变量。

建立项目结构

创建 opengl-start 目录,并保持源码、构建文件和依赖清单分离。build 目录由 CMake 生成,不应提交到版本库。

text
opengl-start/
├── CMakeLists.txt
├── vcpkg.json
└── src/
    └── main.cpp

在项目根目录创建 vcpkg.json。该清单声明工程需要 GLFW 创建窗口和上下文,需要 GLEW 加载 OpenGL 函数。

json
{
  "name": "opengl-start",
  "version-string": "1.0.0",
  "dependencies": [
    "glfw3",
    "glew"
  ]
}

CMake 使用 vcpkg 工具链配置时,会读取该文件并安装缺少的依赖。依赖缓存位于 vcpkg 管理目录,不需要把第三方库复制到项目中。

编写 CMake 配置

在项目根目录创建 CMakeLists.txt。这里要求 C++17,查找系统 OpenGL、GLFW 和 GLEW,并把三者链接到可执行文件。

cmake
cmake_minimum_required(VERSION 3.21)

project(opengl_start LANGUAGES CXX)

set(CMAKE_CXX_STANDARD 17)
set(CMAKE_CXX_STANDARD_REQUIRED ON)
set(CMAKE_CXX_EXTENSIONS OFF)

find_package(OpenGL REQUIRED)
find_package(glfw3 CONFIG REQUIRED)
find_package(GLEW REQUIRED)

add_executable(opengl_start
    src/main.cpp
)

target_link_libraries(opengl_start PRIVATE
    OpenGL::GL
    glfw
    GLEW::GLEW
)

配置成功时,CMake 会生成名为 opengl_start 的目标。验证方法是在后续构建日志中确认 GLFW、GLEW 和 OpenGL 均已找到,并且链接阶段没有未解析符号。

编写最小窗口程序

在 src/main.cpp 中写入完整程序。它创建 OpenGL 3.3 核心模式上下文,初始化 GLEW,输出驱动报告的版本,并持续清空窗口直到用户关闭。

cpp
#include <GL/glew.h>
#include <GLFW/glfw3.h>

#include <iostream>

int main() {
    if (glfwInit() != GLFW_TRUE) {
        std::cerr << "Failed to initialize GLFW\n";
        return 1;
    }

    glfwWindowHint(GLFW_CONTEXT_VERSION_MAJOR, 3);
    glfwWindowHint(GLFW_CONTEXT_VERSION_MINOR, 3);
    glfwWindowHint(GLFW_OPENGL_PROFILE, GLFW_OPENGL_CORE_PROFILE);

#ifdef __APPLE__
    // macOS 创建核心模式上下文时需要前向兼容标志。
    glfwWindowHint(GLFW_OPENGL_FORWARD_COMPAT, GLFW_TRUE);
#endif

    GLFWwindow* window = glfwCreateWindow(
        800,
        600,
        "OpenGL Start",
        nullptr,
        nullptr
    );

    if (window == nullptr) {
        std::cerr << "Failed to create GLFW window\n";
        glfwTerminate();
        return 1;
    }

    glfwMakeContextCurrent(window);
    glfwSwapInterval(1);

    glewExperimental = GL_TRUE;
    const GLenum glewStatus = glewInit();
    if (glewStatus != GLEW_OK) {
        std::cerr << "Failed to initialize GLEW: "
                  << glewGetErrorString(glewStatus) << '\n';
        glfwDestroyWindow(window);
        glfwTerminate();
        return 1;
    }

    // 某些核心模式驱动会让 glewInit 留下一个无害错误,先清除再进入渲染循环。
    while (glGetError() != GL_NO_ERROR) {
    }

    const GLubyte* version = glGetString(GL_VERSION);
    std::cout << "OpenGL: "
              << (version == nullptr
                      ? "unknown"
                      : reinterpret_cast<const char*>(version))
              << '\n';

    while (glfwWindowShouldClose(window) == GLFW_FALSE) {
        int width = 0;
        int height = 0;
        glfwGetFramebufferSize(window, &width, &height);

        glViewport(0, 0, width, height);
        glClearColor(0.10F, 0.16F, 0.24F, 1.0F);
        glClear(GL_COLOR_BUFFER_BIT);

        glfwSwapBuffers(window);
        glfwPollEvents();
    }

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

预期结果:程序构建并运行后,控制台输出驱动报告的 OpenGL 版本,同时显示一个深蓝灰色窗口。

text
OpenGL: <VERSION> <VENDOR-SUFFIX>

程序必须先让窗口上下文成为当前上下文,再调用 glewInit。顺序颠倒时,加载器无法从驱动取得正确的函数地址。

配置、构建与运行

macOS 或 Linux 在项目根目录执行:

bash
cmake -S . -B build -DCMAKE_BUILD_TYPE=Release -DCMAKE_TOOLCHAIN_FILE="$VCPKG_ROOT/scripts/buildsystems/vcpkg.cmake"
cmake --build build
./build/opengl_start

预期输出:

text
OpenGL: <VERSION> <VENDOR-SUFFIX>

同时会出现一个标题为 OpenGL Start 的窗口,背景为深蓝灰色。版本和厂商后缀由本机驱动决定,实际值可能不同。

Windows PowerShell 在项目根目录执行:

powershell
cmake -S . -B build -DCMAKE_TOOLCHAIN_FILE="$env:VCPKG_ROOT\scripts\buildsystems\vcpkg.cmake"
cmake --build build --config Release
& ".\build\Release\opengl_start.exe"

预期输出:

text
OpenGL: <VERSION> <VENDOR-SUFFIX>

如果使用 Ninja 等单配置生成器,可执行文件通常位于 build 根目录,而不是 build/Release。应以 CMake 构建日志中的目标输出路径为准。

典型失败处理

出现 Could not find glfw3 或 Could not find GLEW 时,先确认配置命令包含正确的 vcpkg 工具链路径,再删除 build 目录重新配置。旧缓存可能继续引用错误路径。

链接阶段出现 OpenGL 符号未解析时,检查 target_link_libraries 是否同时包含 OpenGL::GL、glfw 和 GLEW::GLEW。不要只添加头文件目录,头文件可见并不代表链接库已经加入。

glfwCreateWindow 返回空指针时,通常是请求的上下文版本不被当前驱动支持。可先更新显卡驱动;在受限虚拟机或远程桌面中,还要确认环境提供硬件加速。不要直接降低版本并继续使用高版本 API。

本课总结

  • CMake 负责构建,vcpkg 负责依赖,GLFW 创建上下文,GLEW 加载 OpenGL 函数。
  • 可复用工程应把依赖声明、构建配置和源码分开,并使用独立 build 目录。
  • 看到版本输出和深蓝灰色窗口,说明编译、链接、上下文创建与基础渲染链路均已打通。

下一课预告

下一课将从这个工程继续,创建顶点缓冲区、顶点数组对象和着色器程序,完成第一个现代 OpenGL 图元绘制。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

搭建 C++ 开发环境

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通