如何为含数百函数的C++库创建CLI包装器以用于C#？

阿华AIGC实验室

2026-5-7

解决C++库批量生成CLI包装器的高效方案

我太懂你这种面对几百个函数要手动写包装的崩溃了——完全是重复劳动，还容易出错。下面给你几个实用的方案，从工具自动化到CMake集成，帮你省掉99%的手动工作：

1. 用SWIG自动生成完整包装器

这是最省心的方案，SWIG是专门做跨语言包装的工具，能直接解析你的C头文件，生成C/CLI的包装代码，连C#的调用接口都给你做好了。

步骤：

先安装SWIG并把它加到系统PATH里

写一个极简的接口文件（比如my_lib_wrapper.i），告诉SWIG要包装的内容：

%module MyLibCLI
%include "std_string.i"  // 如果你的库用到std::string必须加这个
%{
// 这里放需要引入的C++头文件
#include "your_lib_core.hpp"
#include "another_lib_header.hpp"
%}
// 指定要包装的头文件，SWIG会自动解析里面的函数、类
%include "your_lib_core.hpp"
%include "another_lib_header.hpp"

运行SWIG生成代码：
```
swig -c++ -cli -outdir ./CSharpWrapper my_lib_wrapper.i
```
这会生成C++/CLI的实现文件（MyLibCLI.cpp）和对应的C#类文件
创建C++/CLI项目，把生成的.cpp加进去，链接你之前编译好的.lib库，编译后得到一个.dll
在C#项目里直接引用这个.dll，就能像调用.NET方法一样用C++库的函数了

如果你的库有一些复杂的语法SWIG处理不了，也可以用Clang的Python绑定（clang.cindex）写个小脚本，解析头文件的AST（抽象语法树），精准生成包装代码——比正则靠谱多了，能处理各种复杂的函数签名。

2. 把生成流程集成到CMake里

既然你已经用CMake编译原C++库，直接把包装器的生成和编译集成到CMake脚本里，实现一键搞定：

示例CMake配置：

# 找SWIG
find_package(SWIG REQUIRED)
include(${SWIG_USE_FILE})

# 设置SWIG参数，生成C++/CLI代码
set(CMAKE_SWIG_FLAGS "-c++" "-cli")
set_source_files_properties(my_lib_wrapper.i PROPERTIES CPLUSPLUS ON)

# 生成并编译CLI包装库
swig_add_library(MyLibCLI TYPE SHARED LANGUAGE cli SOURCES my_lib_wrapper.i)
# 链接你的原生静态库
swig_link_libraries(MyLibCLI your_native_static_lib)

# 把生成的C#文件输出到指定目录，方便C#项目引用
set_target_properties(MyLibCLI PROPERTIES SWIG_OUTPUT_DIRECTORY ${CMAKE_CURRENT_BINARY_DIR}/CSharpOutput)

这样你构建CMake项目时，会自动完成代码生成、编译，直接拿到可用的CLI库。

3. 手动编写的偷懒技巧（应急用）

如果暂时不想折腾工具，用正则替换批量生成代码骨架也能省不少事：

把C++头文件里的函数声明全复制出来
在VS或者Notepad++里用正则替换：
- 查找模式：(\w+)\s+(\w+)$([^;]+)$;
- 替换模式：static $1 $2($3) { return ::$2($3); }
  这会生成基础的代理函数，之后再批量处理需要marshaling的类型（比如std::string转System::String^，用msclr::interop::marshal_as）