图形渲染与 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 可以在终端中执行。
cmake --version
git --version预期输出如下,具体版本号可能不同。
cmake version <VERSION>
git version <VERSION>如果终端提示命令不存在,应先完成对应工具安装并重新打开终端。Windows 使用 MSVC 时,建议在 Developer PowerShell 中构建;macOS 和 Linux 可直接使用系统终端。
安装 vcpkg
vcpkg 用于统一安装 GLFW 与 GLEW,避免手工复制头文件和库文件。先选择一个长期保留的目录,并根据操作系统执行初始化。
macOS 或 Linux:
export VCPKG_ROOT="$HOME/tools/vcpkg"
git clone https://github.com/microsoft/vcpkg.git "$VCPKG_ROOT"
"$VCPKG_ROOT/bootstrap-vcpkg.sh"预期结果:
vcpkg package management program version <VERSION>Windows PowerShell:
$env:VCPKG_ROOT = "$HOME\tools\vcpkg"
git clone https://github.com/microsoft/vcpkg.git $env:VCPKG_ROOT
& "$env:VCPKG_ROOT\bootstrap-vcpkg.bat"预期结果:
vcpkg package management program version <VERSION>VCPKG_ROOT 只在当前终端会话中生效。重新打开终端后需要再次设置,或者把它保存为用户环境变量。
建立项目结构
创建 opengl-start 目录,并保持源码、构建文件和依赖清单分离。build 目录由 CMake 生成,不应提交到版本库。
opengl-start/
├── CMakeLists.txt
├── vcpkg.json
└── src/
└── main.cpp在项目根目录创建 vcpkg.json。该清单声明工程需要 GLFW 创建窗口和上下文,需要 GLEW 加载 OpenGL 函数。
{
"name": "opengl-start",
"version-string": "1.0.0",
"dependencies": [
"glfw3",
"glew"
]
}CMake 使用 vcpkg 工具链配置时,会读取该文件并安装缺少的依赖。依赖缓存位于 vcpkg 管理目录,不需要把第三方库复制到项目中。
编写 CMake 配置
在项目根目录创建 CMakeLists.txt。这里要求 C++17,查找系统 OpenGL、GLFW 和 GLEW,并把三者链接到可执行文件。
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,输出驱动报告的版本,并持续清空窗口直到用户关闭。
#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 版本,同时显示一个深蓝灰色窗口。
OpenGL: <VERSION> <VENDOR-SUFFIX>程序必须先让窗口上下文成为当前上下文,再调用 glewInit。顺序颠倒时,加载器无法从驱动取得正确的函数地址。
配置、构建与运行
macOS 或 Linux 在项目根目录执行:
cmake -S . -B build -DCMAKE_BUILD_TYPE=Release -DCMAKE_TOOLCHAIN_FILE="$VCPKG_ROOT/scripts/buildsystems/vcpkg.cmake"
cmake --build build
./build/opengl_start预期输出:
OpenGL: <VERSION> <VENDOR-SUFFIX>同时会出现一个标题为 OpenGL Start 的窗口,背景为深蓝灰色。版本和厂商后缀由本机驱动决定,实际值可能不同。
Windows 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"预期输出:
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 图元绘制。