1. 为什么需要配置MEX编译环境如果你经常用MATLAB处理复杂计算或需要调用C/C代码迟早会遇到MEX文件这个概念。简单来说MEX文件就像是MATLAB和C/C之间的翻译官能让两者无缝协作。但要让这个翻译官正常工作首先得给它配个靠谱的编译器。我在实际项目中遇到过这样的情况MATLAB自带的矩阵运算已经很快了但某个核心算法用C重写后通过MEX调用还能再快3倍。不过第一次配置时确实踩了不少坑比如下载了不兼容的MinGW版本环境变量配错路径导致MATLAB找不到编译器等等。提示MATLAB不同版本对编译器的支持程度不同2020b之后对MinGW的支持明显改善2. 选择合适的MinGW版本2.1 官方推荐版本查询首先打开MATLAB命令行输入mex -setup如果看到未找到支持的编译器的提示说明需要手动安装。建议先查官方文档确认当前MATLAB版本支持的编译器列表我常用的方法是ver记下MATLAB版本号然后到MathWorks官网搜索Supported Compilers。2.2 实际安装建议虽然官方文档可能推荐特定版本但实测发现很多新版本MinGW也能用。我最近在MATLAB 2023a上成功使用了MinGW-w64 8.1.0。关键是要选对架构32位MATLAB需要i686版本64位MATLAB必须用x86_64版本下载地址建议用SourceForge的稳定版本https://sourceforge.net/projects/mingw-w64/files/选择类似x86_64-posix-seh这样的版本这种组合兼容性最好。下载后建议解压到简单路径比如D:\MinGW避免中文或空格路径。3. 详细配置步骤3.1 环境变量设置解压MinGW后需要让系统能找到gcc等工具。以Win10为例右键此电脑 → 属性 → 高级系统设置环境变量 → 系统变量中的Path → 编辑添加MinGW的bin目录例如D:\MinGW\mingw64\bin验证是否成功gcc --version如果显示版本信息说明PATH设置正确。3.2 MATLAB中的配置回到MATLAB命令行setenv(MW_MINGW64_LOC,D:\MinGW\mingw64) mex -setup这时MATLAB应该能识别到MinGW编译器了。如果还提示不兼容可以强制使用mex -setup:D:\MinGW\mingw64\bin\gcc.exe C4. 验证与排错4.1 测试MEX编译用MATLAB自带的示例测试edit([matlabroot /extern/examples/mex/mexfunction.c]) mex mexfunction.c mexfunction(1,2,3)应该能看到输入输出参数的统计信息。4.2 常见问题解决如果遇到LINK : fatal error LNK1104错误可能是防病毒软件拦截临时关闭试试权限不足用管理员身份运行MATLAB路径包含空格或特殊字符对于未定义引用错误通常是缺少库文件需要在mex命令中添加mex(-LD:\MinGW\mingw64\lib, yourfile.c)5. 高级配置技巧5.1 多版本编译器管理我习惯用环境变量切换不同MATLAB版本对应的编译器% 在startup.m中添加 if strcmp(version(-release),2023a) setenv(MW_MINGW64_LOC,D:\MinGW\8.1.0) else setenv(MW_MINGW64_LOC,D:\MinGW\7.3.0) end5.2 性能优化选项在mex命令中添加优化标志mex -O CFLAGS-O3 -marchnative yourfile.c这能让生成的代码更快但编译时间会稍长。6. 跨平台注意事项虽然主要在Windows下配置但如果在Linux/Mac上也需要用MinGWLinux下通常直接用系统包管理器安装gccMac需要安装Xcode命令行工具跨平台项目建议用mexext获取当前平台的后缀名ext mexext; disp([当前平台扩展名 ext])配置过程中最常遇到的坑就是版本不匹配。有次我为了一个老项目不得不专门安装MATLAB 2017b和对应的MinGW 5.3.0。建议新建一个文本文件记录各个环境对应的版本号下次重装系统时能省不少时间。
在MATLAB中快速搭建MEX与MinGW的跨平台编译环境
发布时间：2026/5/19 17:13:33
1. 为什么需要配置MEX编译环境如果你经常用MATLAB处理复杂计算或需要调用C/C代码迟早会遇到MEX文件这个概念。简单来说MEX文件就像是MATLAB和C/C之间的翻译官能让两者无缝协作。但要让这个翻译官正常工作首先得给它配个靠谱的编译器。我在实际项目中遇到过这样的情况MATLAB自带的矩阵运算已经很快了但某个核心算法用C重写后通过MEX调用还能再快3倍。不过第一次配置时确实踩了不少坑比如下载了不兼容的MinGW版本环境变量配错路径导致MATLAB找不到编译器等等。提示MATLAB不同版本对编译器的支持程度不同2020b之后对MinGW的支持明显改善2. 选择合适的MinGW版本2.1 官方推荐版本查询首先打开MATLAB命令行输入mex -setup如果看到未找到支持的编译器的提示说明需要手动安装。建议先查官方文档确认当前MATLAB版本支持的编译器列表我常用的方法是ver记下MATLAB版本号然后到MathWorks官网搜索Supported Compilers。2.2 实际安装建议虽然官方文档可能推荐特定版本但实测发现很多新版本MinGW也能用。我最近在MATLAB 2023a上成功使用了MinGW-w64 8.1.0。关键是要选对架构32位MATLAB需要i686版本64位MATLAB必须用x86_64版本下载地址建议用SourceForge的稳定版本https://sourceforge.net/projects/mingw-w64/files/选择类似x86_64-posix-seh这样的版本这种组合兼容性最好。下载后建议解压到简单路径比如D:\MinGW避免中文或空格路径。3. 详细配置步骤3.1 环境变量设置解压MinGW后需要让系统能找到gcc等工具。以Win10为例右键此电脑 → 属性 → 高级系统设置环境变量 → 系统变量中的Path → 编辑添加MinGW的bin目录例如D:\MinGW\mingw64\bin验证是否成功gcc --version如果显示版本信息说明PATH设置正确。3.2 MATLAB中的配置回到MATLAB命令行setenv(MW_MINGW64_LOC,D:\MinGW\mingw64) mex -setup这时MATLAB应该能识别到MinGW编译器了。如果还提示不兼容可以强制使用mex -setup:D:\MinGW\mingw64\bin\gcc.exe C4. 验证与排错4.1 测试MEX编译用MATLAB自带的示例测试edit([matlabroot /extern/examples/mex/mexfunction.c]) mex mexfunction.c mexfunction(1,2,3)应该能看到输入输出参数的统计信息。4.2 常见问题解决如果遇到LINK : fatal error LNK1104错误可能是防病毒软件拦截临时关闭试试权限不足用管理员身份运行MATLAB路径包含空格或特殊字符对于未定义引用错误通常是缺少库文件需要在mex命令中添加mex(-LD:\MinGW\mingw64\lib, yourfile.c)5. 高级配置技巧5.1 多版本编译器管理我习惯用环境变量切换不同MATLAB版本对应的编译器% 在startup.m中添加 if strcmp(version(-release),2023a) setenv(MW_MINGW64_LOC,D:\MinGW\8.1.0) else setenv(MW_MINGW64_LOC,D:\MinGW\7.3.0) end5.2 性能优化选项在mex命令中添加优化标志mex -O CFLAGS-O3 -marchnative yourfile.c这能让生成的代码更快但编译时间会稍长。6. 跨平台注意事项虽然主要在Windows下配置但如果在Linux/Mac上也需要用MinGWLinux下通常直接用系统包管理器安装gccMac需要安装Xcode命令行工具跨平台项目建议用mexext获取当前平台的后缀名ext mexext; disp([当前平台扩展名 ext])配置过程中最常遇到的坑就是版本不匹配。有次我为了一个老项目不得不专门安装MATLAB 2017b和对应的MinGW 5.3.0。建议新建一个文本文件记录各个环境对应的版本号下次重装系统时能省不少时间。
