如何包装含<future>的C++类隐藏该头文件以支持/clr编译并供.NET Core调用

核心问题根源 #

你之前踩的坑本质是头文件引用的传递性：只要你在任何会被/clr编译流程扫描到的头文件里写了#include "../Client/Client.hh"，预处理器就会顺着这条引用把<future>、std::map这类和托管编译不兼容的原生STL头全部展开，最终触发编译报错。
很多资料提到的"分层包装"思路，核心不是简单的类套娃，而是通过PIMPL（不透明指针）模式，把所有对带<future>的原生库的依赖，全部隐藏到纯原生编译的实现文件里，彻底切断头文件层面的引用传递。

具体分层实现逻辑 #

第一层：纯原生隔离包装层（完全不开启/clr编译） #

这一层的核心原则是：对外暴露的头文件里，绝对不能出现任何对原jetbridge::Client、<future>的直接include。

1. 先写干净的原生包装头文件（比如命名为NativeClientWrapper.h），只做前置声明，不引入带不兼容头的依赖：

   #pragma once
   // 只前置声明原原生类，不include它的头文件
   namespace jetbridge { class Client; }
   
   // 纯原生C++类，没有任何托管代码标记
   class NativeClientWrapper {
   private:
       // 用不透明指针持有原生Client实例，不需要知道原生类的具体定义
       jetbridge::Client* _nativeClient = nullptr;
   public:
       NativeClientWrapper(void* simconnectHandle);
       ~NativeClientWrapper();
       int SendRequest(char* data, int timeout, void** outPacket);
       void HandleReceivedClientEvent(void* event);
   };
   

2. 写对应的实现文件NativeClientWrapper.cpp，这个文件设置为纯原生编译（关闭/clr选项），在这里才去include所有带<future>的原生头：

   #include "NativeClientWrapper.h"
   // 所有带不兼容STL的头，全部放在这里引入，不会传递到后续托管编译单元
   #include "../Client/Client.hh"
   #include "../Protocol/Protocol.hh"
   
   NativeClientWrapper::NativeClientWrapper(void* simconnectHandle) {
       // 纯原生编译单元下，可以正常实例化带std::promise成员的原生Client
       _nativeClient = new jetbridge::Client(simconnectHandle);
   }
   
   NativeClientWrapper::~NativeClientWrapper() {
       delete _nativeClient;
   }
   
   int NativeClientWrapper::SendRequest(char* data, int timeout, void** outPacket) {
       // 所有std::future/promise的等待、异常消化逻辑，全部在这个纯原生单元内完成
       Packet* result = _nativeClient->request(data, timeout);
       *outPacket = result;
       return 0;
   }
   
   void NativeClientWrapper::HandleReceivedClientEvent(void* event) {
       _nativeClient->handle_received_client_data_event(event);
   }
   

第二层：C++/CLI托管包装层（开启/clr编译） #

这一层的头文件只需要引入刚才写的干净的NativeClientWrapper.h，绝对不要直接include原jetbridge的头文件：

#pragma once
#include "NativeClientWrapper.h" // 这个头没有任何<future>相关内容，不会触发编译错误
using namespace System;

namespace ClrClient {
    public ref class ClientWrapper {
    private:
        NativeClientWrapper* _nativeWrapper;
    public:
        ClientWrapper(IntPtr simconnectHandle);
        ~ClientWrapper();
        !ClientWrapper();
        array<Byte>^ SendRequest(array<Byte>^ data, int timeout);
        void HandleReceivedEvent(IntPtr eventHandle);
    };
}

编译配置关键注意点 #

• 必须单独把NativeClientWrapper.cpp的编译属性改成关闭公共语言运行时支持（/clr），确保它按纯原生C++编译，碰到<future>不会有兼容问题
• 所有带托管代码的文件（比如ClientWrapper.cpp）保持/clr编译，因为它们的include路径里根本不会出现<future>的痕迹，也就不会触发之前的编译错误

常见避坑提示：绝对不要让原生包装类继承自原jetbridge::Client，一旦继承，包装类的头文件就必须引入基类的头定义，又会把<future>重新带入include链，破坏隔离效果。

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