使用前向声明时，std::vector<std::unique_ptr<RenderPass>>编译报错求解

问题原因 #

单个std::unique_ptr<RenderPass>能正常编译，是因为unique_ptr的默认删除器只会在析构函数实例化时才要求RenderPass是完整类型。你已经在头文件中声明了~RenderSystem();，没有在头文件里提供默认实现，编译器会把析构函数的实例化推迟到.cpp文件中（此时你可以引入RenderPass的完整定义）。

而std::vector<std::unique_ptr<RenderPass>>触发错误，是因为vector的模板实例化过程中，部分成员函数（比如析构函数、内存扩容时的元素移动/销毁逻辑）会在类定义阶段就尝试实例化unique_ptr的删除器。此时RenderPass还是前向声明的不完整类型，触发了static_assert检查。

解决方案 #

核心思路是把所有会触发unique_ptr删除器实例化的逻辑，都放到RenderPass完整定义之后的.cpp文件中：

1. 头文件（RenderSystem.h）：只声明类和成员，不提供会操作vector的函数实现

class RenderPass;

class RenderSystem final
{
public:
    RenderSystem();
    ~RenderSystem();

    // 如果有操作m_render_passes的函数，只做声明
    void addRenderPass(std::unique_ptr<RenderPass> pass);

private:
    std::unique_ptr<RenderPass> c;
    std::vector<std::unique_ptr<RenderPass>> m_render_passes;
};

2. 实现文件（RenderSystem.cpp）：引入RenderPass的完整定义，再实现所有成员函数

#include "RenderSystem.h"
#include "RenderPass.h" // 这里RenderPass是完整类型

RenderSystem::RenderSystem() = default;

RenderSystem::~RenderSystem() = default;

void RenderSystem::addRenderPass(std::unique_ptr<RenderPass> pass)
{
    m_render_passes.push_back(std::move(pass));
}

补充说明 #

• 不要在头文件中直接初始化vector（比如m_render_passes {}），也不要在头文件里实现任何会修改vector的成员函数，这些操作都会提前触发unique_ptr删除器的实例化检查。
• 本质是利用C++的"模板实例化延迟"特性，把依赖完整类型的逻辑推迟到.cpp文件中，避开前向声明带来的类型不完整问题。

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