Windows 下 MATLAB 与 C/C++ 混合编程：DLL 生成与调用

源文件 MatlabCppMix.cpp

#include "MatlabCppMix.h"
#include <string.h>

// 矩阵加法实现：C = A + B
void MatrixAdd(double* A, double* B, double* C, int m, int n) {
    for (int i = 0; i < m * n; i++) {
        C[i] = A[i] + B[i];
    }
}

// 结构体数据缩放：point->x = point->x * scale; point->y = point->y * scale
void ScalePoint(PointData* point, double scale) {
    if (point == nullptr) {
        return; // 空指针判断，避免内存错误
    }
    point->x *= scale;
    point->y *= scale;
    // 标签追加"_scaled"
    strcat_s(point->label, sizeof(point->label), "_scaled");
}

2. 编译生成 DLL（Visual Studio 两种方法）

方法 1：使用 Visual Studio 图形界面编译（推荐新手）

1. 打开 Visual Studio，创建新项目 → 选择动态链接库（DLL） → 项目命名为MatlabCppMix。
2. 将上述MatlabCppMix.h和MatlabCppMix.cpp添加到项目中。
3. 配置项目属性：
   • 右键项目 → 属性 → 配置属性 → 常规 → 平台工具集选择对应 VS 版本（如v143）。
   • 配置属性 → C/C++ → 所有选项 → 确保平台为x64（必须与 MATLAB 位数一致）。
   • 配置属性 → 链接器 → 高级 → 目标文件扩展名为.dll。
4. 点击生成 → 生成解决方案，在x64/Debug或x64/Release目录下生成MatlabCppMix.dll。

方法 2：使用命令行编译（适合开发者）

打开x64 Native Tools Command Prompt，切换到源码目录，执行以下命令：

cl /LD MatlabCppMix.cpp /Fe:MatlabCppMix.dll 

• /LD：指定编译为动态链接库。
• /Fe：指定输出 DLL 文件名。

编译成功后，会生成MatlabCppMix.dll、MatlabCppMix.lib和MatlabCppMix.exp文件。

三、Step 2：MATLAB 中加载 DLL 并调用函数

1. 核心函数说明

2. MATLAB 脚本实现：数据传递与函数调用

创建CallDllDemo.m脚本，实现矩阵加法和结构体处理的完整调用流程，包含错误处理和内存管理。

% MATLAB 调用 C/C++ DLL 实战脚本
clear; clc; close all;

%% 1. 配置路径与参数
dllPath = 'MatlabCppMix.dll'; % DLL 文件路径（建议使用绝对路径）
hFile = 'MatlabCppMix.h'; % 头文件路径
m = 2; n = 3; % 矩阵维度：2 行 3 列

%% 2. 加载 DLL（含错误处理）
if ~libisloaded('MatlabCppMix')
    try
        loadlibrary(dllPath, hFile);
        disp('DLL 加载成功！');
        % 查看导出函数接口
        libfunctions('MatlabCppMix','-full');
    catch ME
        error('DLL 加载失败：%s', ME.message);
    end
end

%% 3. 调用函数 1：矩阵加法（double 数组传递）
try
    % 构造输入矩阵
    A = rand(m, n);
    B = rand(m, n);
    % 初始化输出矩阵（必须预分配内存）
    C = zeros(m, n);
    % 调用 DLL 中的 MatrixAdd 函数
    % 注意：MATLAB 矩阵是列优先存储，C/C++ 是行优先存储，需转置后传递！
    calllib('MatlabCppMix','MatrixAdd', A', B', C', m, n);
    C = C'; % 转置回 MATLAB 列优先格式
    % 输出结果
    disp('===== 矩阵加法结果 =====');
    disp('矩阵 A：');
    disp(A);
    disp('矩阵 B：');
    disp(B);
    disp('矩阵 C = A + B：');
    disp(C);
catch ME
    warning('矩阵加法调用失败：%s', ME.message);
end

%% 4. 调用函数 2：结构体数据处理
try
    % 定义 MATLAB 结构体，与 C/C++ 的 PointData 对应
    point = struct('x',1.5,'y',2.5,'label','origin_point');
    % 将 MATLAB 结构体转换为 C 结构体（关键步骤）
    cPoint = libstruct('PointData');
    cPoint.x = point.x;
    cPoint.y = point.y;
    cPoint.label = point.label;
    scale = 2.0; % 缩放因子
    % 调用 DLL 中的 ScalePoint 函数
    calllib('MatlabCppMix','ScalePoint', cPoint, scale);
    % 输出处理后的结构体数据
    disp('===== 结构体缩放结果 =====');
    disp(['原始坐标：(',num2str(point.x),', ',num2str(point.y),')']);
    disp(['缩放后坐标：(',num2str(cPoint.x),', ',num2str(cPoint.y),')']);
    disp(['标签：', cPoint.label]);
catch ME
    warning('结构体处理调用失败：%s', ME.message);
end

%% 5. 卸载 DLL，释放内存
if libisloaded('MatlabCppMix')
    unloadlibrary('MatlabCppMix');
    disp('DLL 已卸载！');
end

3. 关键注意事项（避坑指南）

1. 数据存储顺序差异：MATLAB 矩阵是列优先存储，C/C++ 是行优先存储。传递二维数组时，需先对 MATLAB 矩阵转置（A'），调用后再转置回原格式。
2. 内存预分配：MATLAB 中输出数组（如示例中的C）必须提前用zeros初始化，否则会导致内存访问错误。
3. 结构体类型匹配：使用libstruct函数将 MATLAB 结构体转换为 C 结构体，确保字段名、类型完全一致（如char[20]对应 MATLAB 的字符串）。
4. 位数一致性：必须确保 DLL 是x64架构，与 MATLAB 的 64 位版本匹配，否则会出现loadlibrary失败。

四、Step 3：内存管理与常见错误排查

1. 内存管理最佳实践

• 避免重复加载 DLL：使用libisloaded函数判断 DLL 是否已加载，防止内存泄漏。
• 及时卸载 DLL：脚本运行结束后，调用unloadlibrary释放资源，尤其是长时间运行的程序。
• C/C++端空指针检查：在导出函数中添加nullptr判断（如示例中的ScalePoint函数），避免 MATLAB 传递空指针导致崩溃。

2. 常见错误及解决方案

五、扩展内容：loadlibrary vs MEX 文件 适用场景与性能对比

除了 DLL 调用，MATLAB 与 C/C++ 混合编程还有另一种主流方式——MEX 文件。两种方式各有优劣，选择需结合实际需求：

选型建议：

• 若已有成熟的 C/C++ 算法库，优先选择DLL 调用，快速实现复用。
• 若追求极致性能，或需要在 MATLAB 中直接调用自定义函数，选择MEX 文件。

六、总结

本文通过完整的代码示例，详细讲解了 Windows 环境下 MATLAB 与 C/C++ 混合编程的核心流程：从 C/C++ DLL 的编写、编译，到 MATLAB 中加载 DLL、调用函数、处理数据交互，同时涵盖了内存管理、错误排查和两种混合编程方式的对比。掌握这一技术，你可以轻松结合 MATLAB 的易用性和 C/C++ 的高性能，解决科学计算与工程开发中的复杂问题！