OpenGL资源ID是无符号整数而非内存指针， glGenBuffers等函数通过指针参数写入ID，需在类成员中声明GLuint并传其地址，析构时调用glDeleteBuffers清理；void*传参实际被解释为字节偏移而非地址，须用offsetof避免误传地址；智能指针不能直接管理OpenGL资源，应封装RAII类确保自动释放。
指针用于管理 OpenGL 资源句柄时必须手动配对 glDelete*
OpenGL 的 glGenBuffers、glGenTextures 等函数不返回对象本身，而是通过指针参数写入 GLuint ID。如果你传入的是局部变量地址，后续无法在类外访问该 ID；若传入堆分配的 GLuint*，又容易忘记释放。
常见错误是：只调用 glGenBuffers(1, &vboID)，但把 vboID 存在栈上，类析构时无法清理；或用 new GLuint 分配却漏掉 glDeleteBuffers(1, vboIDPtr)。
- 推荐做法：在类成员中直接声明
GLuint vboID = 0;，构造时传&vboID给glGenBuffers，析构时调用glDeleteBuffers(1, &vboID) - 不要用
GLuint* vboIDPtr = new GLuint;—— 没必要且易泄漏 - 注意：OpenGL 资源 ID 是无符号整数，不是真正“指向内存”的指针，但 API 设计强制你用指针传参，这是历史包袱
void* 传顶点数据时必须匹配 glVertexAttribPointer 的 stride 和 offset
向 GPU 上传顶点数组时，glBufferData 接收 const void*，而 glVertexAttribPointer 的最后一个参数也是 const void* —— 但它实际被解释为字节偏移量（不是地址），这点极易误解。
典型错误：把 &vertices[0].x 直接传给 glVertexAttribPointer，结果在非调试模式下可能偶然正常，但在不同编译器或结构体对齐设置下崩溃。
立即学习“C++免费学习笔记（深入）”；
组合式C++代码评审方案，融合静态分析、AI推理、多轮迭代评审和C++专项检查，适用于PR审查、增量代码审查、全项目评审和代码质量评分，触发词包括review cpp、cpp代码评审、C++review、代码审查。
- 正确写法是传整数偏移，例如
offsetof(Vertex, x)或(void*)offsetof(Vertex, x) - 如果顶点结构体有 padding（比如
struct Vertex { float x,y,z; int color; };），sizeof(Vertex)和字段真实偏移可能不等，必须用offsetof - 别依赖
reinterpret_cast<void>(vertices.data())</void>做 offset —— 这是地址，不是偏移
智能指针不能直接管理 OpenGL 资源，但可封装 RAII 类
std::unique_ptr 或 std::shared_ptr 无法自动调用 glDeleteTextures 这类 C 风格清理函数，因为它们默认用 delete，而 OpenGL ID 不是 new 出来的内存。
强行绑定会导致运行时未定义行为，比如：std::unique_ptr<gluint decltype> texPtr(&texID, glDeleteTextures);</gluint> —— 错！glDeleteTextures 第一个参数是 GLsizei，不是 GLuint*。
- 安全做法：写一个轻量 RAII 类，如
class GLTexture { GLuint id_ = 0; ~GLTexture() { if (id_) glDeleteTextures(1, &id_); } }; - 避免在 RAII 类里裸存
GLuint*—— 容易误传地址而非值 - 如果多个地方共享同一纹理 ID，不要用引用计数封装，OpenGL 本身不跟踪引用关系，重复
glDelete会出错
指针算术在顶点缓冲区映射中容易越界
调用 glMapBuffer 返回 void*，常被 reinterpret_cast 成 float* 或 Vertex* 后做指针加减。但缓冲区实际大小由 glBufferData 的 size 参数决定，和 C++ 数组长度无关。
常见现象：循环写 mappedPtr[i] 时用 vertices.size() 当上限，但 GPU 缓冲区可能更小（比如只分配了前 100 个顶点空间），导致写越界、渲染异常或驱动崩溃。
- 务必用
glGetBufferParameteriv(GL_ARRAY_BUFFER, GL_BUFFER_SIZE, &size)获取真实分配字节数，再换算成元素个数 - 映射后检查返回值是否为
nullptr—— 显存不足时可能失败 - 写完必须调用
glUnmapBuffer，否则后续glDrawArrays可能读到脏数据
C++ 图形学里最危险的指针问题，往往不是空指针或野指针，而是你以为它在干一件事（比如传地址），其实 OpenGL 在按另一套规则解释它（比如当偏移量）。每次传指针前，先确认 API 文档里那个参数到底要什么类型、谁负责生命周期、有没有隐式转换陷阱。
