MATLAB调用MinGW-w64 C++编译器：从环境搭建到MEX文件编译实战-深圳市維司達科技有限公司

1. 为什么需要MATLAB调用C++编译器？

很多MATLAB用户可能不知道，当遇到计算密集型任务时，纯MATLAB代码的执行效率可能不尽如人意。这时候就需要借助C++这种高性能语言来编写关键部分的代码，然后通过MEX文件的方式让MATLAB调用。我刚开始做图像处理项目时就深有体会，一个复杂的滤波算法在MATLAB里跑要十几秒，改用C++重写后编译成MEX文件，执行时间直接缩短到毫秒级。

MinGW-w64是Windows平台上一个非常优秀的GNU编译器集合，它完全免费且支持最新的C++标准。相比MATLAB自带的LCC编译器，MinGW-w64不仅支持C++17/20特性，还能生成64位代码，这对现代科学计算来说至关重要。不过配置过程确实容易踩坑，我当初就折腾了好几天才搞定各种环境问题。

2. 安装MinGW-w64的正确姿势

2.1 获取可靠的安装包

网上很多教程推荐的SourceForge下载源经常会出现"The file has been downloaded incorrectly"错误。经过多次尝试，我发现直接从MSYS2官网获取安装包最可靠：

https://www.msys2.org/

安装时建议选择默认路径C:\msys64，这样可以避免后续路径问题。安装完成后，我们需要通过pacman安装必要的工具链：

pacman -Syu pacman -S --needed base-devel mingw-w64-x86_64-toolchain

2.2 配置系统环境变量

这一步很关键但容易被忽略。我们需要将MinGW-w64的bin目录添加到系统PATH中：

右键"此电脑"选择"属性"
点击"高级系统设置"
选择"环境变量"
在系统变量中找到Path并编辑
添加新路径：C:\msys64\mingw64\bin

验证安装是否成功：

g++ --version

如果看到类似"g++ (Rev6, Built by MSYS2 project) 12.2.0"的输出，说明安装正确。

3. MATLAB中的编译器配置

3.1 设置编译器路径

在MATLAB命令窗口中执行：

setenv('MW_MINGW64_LOC','C:\msys64\mingw64')

这个命令告诉MATLAB在哪里可以找到MinGW-w64编译器。需要注意的是，路径中不能有中文或特殊字符，否则会导致后续编译失败。

3.2 验证编译器配置

执行以下命令检查MATLAB是否能识别编译器：

mex -setup C++

如果配置正确，你会看到类似这样的输出：

MEX configured to use 'MinGW64 Compiler (C++)' for C++ language compilation.

4. 编译你的第一个MEX文件

4.1 准备C++源代码

创建一个简单的hello.cpp文件：

#include "mex.h" void mexFunction(int nlhs, mxArray *plhs[], int nrhs, const mxArray *prhs[]) { mexPrintf("Hello from C++!\n"); }

4.2 编译并测试

在MATLAB中导航到源代码目录，执行：

mex hello.cpp

然后调用生成的MEX文件：

hello

如果一切顺利，你应该会在命令窗口看到"Hello from C++!"的输出。

5. 常见问题排查

5.1 编译器不兼容问题

有时候会遇到这样的错误：

Error using mex The specified compiler is not supported for MEX file generation.

这通常是因为MATLAB版本和编译器版本不匹配。MATLAB每年更新时都会测试特定的编译器版本，可以在MathWorks官网查询兼容性列表。我的经验是，对于MATLAB R2022b，使用MinGW-w64 GCC 10.3.0最稳定。

5.2 链接错误处理

如果编译时出现链接错误，比如：

undefined reference to `mxCreateDoubleMatrix'

这通常是因为没有正确包含MATLAB的库路径。解决方法是在mex命令中添加必要的链接选项：

mex -I"C:\Program Files\MATLAB\R2022b\extern\include" -L"C:\Program Files\MATLAB\R2022b\extern\lib\win64\mingw64" -lMatlabDataArray -lMatlabEngine hello.cpp

6. 性能优化技巧

6.1 编译器优化选项

通过添加编译优化选项可以显著提升MEX文件性能：

mex COPTIMFLAGS='-O3' CXXOPTIMFLAGS='-O3' hello.cpp

-O3表示最高级别的优化，但会增加编译时间。对于大型项目，我建议开发时使用-O0（无优化）便于调试，发布时再改用-O3。

6.2 多线程编程

利用C++的多线程能力可以充分发挥现代CPU的性能。比如使用OpenMP：

#include <omp.h> void mexFunction(...) { #pragma omp parallel for for(int i=0; i<100; ++i) { // 并行计算代码 } }

编译时需要添加OpenMP支持：

mex CXXFLAGS='-fopenmp' LDFLAGS='-fopenmp' hello.cpp

7. 混合编程进阶技巧

7.1 处理MATLAB数组

在C++中操作MATLAB数组需要特别小心内存管理。比如创建一个2x2的double矩阵：

mxArray *mat = mxCreateDoubleMatrix(2, 2, mxREAL); double *data = mxGetPr(mat); data[0] = 1.0; // (1,1) data[1] = 2.0; // (2,1) data[2] = 3.0; // (1,2) data[3] = 4.0; // (2,2)

7.2 异常处理

C++异常必须捕获在MEX函数内部，否则会导致MATLAB崩溃：

try { // 可能抛出异常的代码 } catch(const std::exception& e) { mexErrMsgIdAndTxt("MyToolbox:error", e.what()); }

8. 项目实战：图像处理加速

我曾经用这种技术加速一个图像去噪算法。MATLAB原型处理一张1024x1024的图像需要12秒，改用C++实现并编译为MEX文件后，处理时间降到了0.3秒。关键代码如下：

void denoiseImage(const mxArray *input, mxArray *output) { double *in = mxGetPr(input); double *out = mxGetPr(output); int rows = mxGetM(input); int cols = mxGetN(input); #pragma omp parallel for for(int i=1; i<rows-1; ++i) { for(int j=1; j<cols-1; ++j) { // 实现双边滤波算法 out[i+j*rows] = bilateralFilter(in, i, j, rows); } } }

编译时使用：

mex -O CXXFLAGS='-fopenmp -march=native' LDFLAGS='-fopenmp' denoise.cpp

这个案例充分展示了混合编程的威力 - 既保持了MATLAB的快速原型开发优势，又获得了接近原生C++的性能。

MATLAB调用MinGW-w64 C++编译器：从环境搭建到MEX文件编译实战