如何隐藏GLFW/GLEW头文件引用？C++ OpenGL窗口类库优化问询

针对你这个OpenGL窗口类的封装需求，有几个实用技巧可以彻底隐藏GLFW和GLEW的头文件引用，同时保持代码整洁：

1. 前置声明（Forward Declarations） #

你的头文件里只用到了GLFWwindow*和GLFWmonitor*指针类型，不需要GLFW的完整类定义，直接用前置声明替代头文件引入即可：

修改后的头文件：

#include <IWindow.h>
#include <string>

// 前置声明GLFW的类型，替代#include <GLFW/glfw3.h>
struct GLFWwindow;
struct GLFWmonitor;

class Window : public IWindow
{
public:
    Window(int width, int height, std::string caption,
        bool fullscreen = false);

    ~Window();

protected:
    int m_width;
    int m_height;
    std::string m_caption;
    GLFWwindow *m_window;
    GLFWmonitor *m_monitor;
    bool m_fullscreen;

    static void KeyInputCallBack(GLFWwindow *window, int key, int scancode,
        int action, int mods);
        
    static void CursorPositionCallBack(GLFWwindow *window, double xPos,
    double yPos);

    static void CallbackResize(GLFWwindow* window, int cx, int cy);
};

然后在Window.cpp中再引入GLFW头文件：

#include <GLFW/glfw3.h>
#include "Window.h"
// 编写类的实现逻辑

这种方式最轻量化，完全避免在公共头文件中暴露GLFW依赖。

2. Pimpl惯用法（彻底隐藏实现细节） #

如果想把所有GLFW相关的实现细节完全隔离，不让外部感知，可以用Pimpl（Pointer to Implementation）模式：

公共头文件（Window.h） #

#include <IWindow.h>
#include <string>
#include <memory>

class WindowImpl; // 前置声明内部实现类

class Window : public IWindow
{
public:
    Window(int width, int height, std::string caption,
        bool fullscreen = false);

    ~Window();

protected:
    // 所有GLFW相关成员都移到内部实现类中
    std::unique_ptr<WindowImpl> m_impl;
};

内部实现文件（Window.cpp） #

#include <GLFW/glfw3.h>
#include "Window.h"

// 定义内部实现类，包含所有GLFW相关内容
class WindowImpl
{
public:
    int m_width;
    int m_height;
    std::string m_caption;
    GLFWwindow *m_window;
    GLFWmonitor *m_monitor;
    bool m_fullscreen;

    static void KeyInputCallBack(GLFWwindow *window, int key, int scancode,
        int action, int mods);
        
    static void CursorPositionCallBack(GLFWwindow *window, double xPos,
    double yPos);

    static void CallbackResize(GLFWwindow* window, int cx, int cy);
};

// 实现Window类的构造、析构等方法
Window::Window(int width, int height, std::string caption, bool fullscreen)
    : m_impl(std::make_unique<WindowImpl>())
{
    m_impl->m_width = width;
    m_impl->m_height = height;
    m_impl->m_caption = std::move(caption);
    m_impl->m_fullscreen = fullscreen;
    // 这里编写GLFW窗口初始化逻辑
}

Window::~Window() = default;

这种方式把GLFW依赖完全封装在cpp文件中，外部用户完全不知道你的库使用了GLFW，是库封装的最佳实践之一。

3. 内部公共依赖头文件 #

如果你的库有多个类需要用到GLFW/GLEW，可以创建一个仅内部使用的公共依赖头文件（比如LibInternalDependencies.h），集中引入第三方依赖：

// LibInternalDependencies.h（仅库内部使用，不对外暴露）
#include <GLFW/glfw3.h>
#include <GL/glew.h>

然后库内所有cpp文件都包含这个头文件，公共头文件（如Window.h）只保留必要的标准库和接口头（IWindow.h），配合前置声明使用。这种方式可以避免在多个cpp中重复写引入语句，同时保持公共头文件的简洁。

内容的提问来源于stack exchange，提问作者Swatcat