MATLAB转C/C++实战：mcc与Matcom选型、配置与部署全解析

简介：面向具备Matlab与C语言基础、希望脱离Matlab环境部署算法的开发人员，这份docx文档系统讲解了将Matlab程序转换为C语言的两类主流实现路径：一是基于Matlab Compiler与mcc命令生成独立可执行文件，二是借助MATcom v4.5将m文件转化为C/C++代码并集成到Visual C++ 6.0中。全篇从编译器安装配置、M文件格式要求，到MCR运行时部署与环境变量设置均有细致说明，并配有具体转换实例和常见问题提醒，能帮助读者避开函数定义不规范、编译器版本不兼容等典型坑点。资源为单个docx文档，大小仅24KB，内容紧凑、步骤完整，适合边看边操作。已有265人学习下载，是算法移植与跨平台部署的实用参考。

1. 为什么要把MATLAB程序改成C：从mcc到Matcom的选型问题

把MATLAB的m文件“翻译”成C语言，并不是逐行转换成C代码，而是生成一堆包装代码，真正的数学库仍以动态库方式被调用。打开mcc生成的.c文件时，里面满是mwArray和指针操作，核心算法藏在库里。因此，让编译后的程序彻底脱离MATLAB运行时是不可能的，但把它变成能被C/C++工程调用、能在没装MATLAB的机器上跑的二进制，则是完全可行的。这就是MATLAB混合编程的典型场景。实现路径有两条：一是用MATLAB自带的Compiler（mcc命令），将function型M文件编译成C/C++代码、静态库或独立exe；二是用第三方工具Matcom v4.5，把M文件转换成C++代码并集成进Visual C++ 6.0。下面结合一个FFT小例子，把环境配置、编译参数、运行时部署和VC6.0集成讲清楚。

2. 搭建Matlab Compiler环境：mbuild -setup与编译器识别

2.1 先确认Compiler是否已安装

很多人在安装MATLAB时选择了默认组件，Compiler其实已经装上了，但并不知道。判断方法很简单，在命令窗口敲mbuild，如果提示“未定义命令”，说明Compiler组件缺失；如果提示需要mbuild -setup，说明已安装但没配置。我最早在Matlab 7.0.1上踩过一个坑：只装了MATLAB主程序，没有选Compiler工具包，导致后续所有mcc尝试都失败。解决办法是重新运行安装程序，按标准MATLAB安装教程勾选“MATLAB Compiler”和“MATLAB Builder for C/C++”组件。安装好后，版本信息可以通过ver命令查看，确认列表里出现“MATLAB Compiler”。

2.2 执行mbuild -setup并选择C编译器

配置Compiler的核心命令就是mbuild -setup。在MATLAB命令窗口执行后，会列出当前系统可用的C编译器。

mbuild -setup

交互过程大致是这样：

Please choose your compiler for building standalone MATLAB applications: [1] Lcc-win32 C 2.4.1 [2] Microsoft Visual C++ 2005 ... Select compiler [1]: 2 Are these correct? ([y]/n): y

这里选择哪个编译器会影响后续生成代码的ABI。我一般优先选系统已安装的Visual C++，因为最终要嵌入到VC工程时，编译器一致可以避免大量头文件和运行库冲突。如果机器上只装了MATLAB，则选自带的Lcc-win32，它对大多数纯计算M文件够用。选完后，MATLAB会把配置写入compopts.bsp之类的文件。

2.3 编译器识别的边界：为什么VC++8.0可能不被识别

场景中有一个经典问题：有些人的机器装的是VC++2005，但当时MATLAB版本（比如7.0）的mbuild就是不认VC++8.0。我第一次遇到时也以为是自己安装错了，反复重装VC和MATLAB。后来明白，mbuild依赖MATLAB自带的编译器配置文件，新版本VC编译器没有对应的选项时，它就无法感知。这时候有两个处理方案：一是改用MATLAB自带的Lcc编译器，选择它虽然生成的代码在编译速度上稍慢，但稳定性没问题；二是升级MATLAB到支持该VC版本的发布版，或者安装对应的SDK和补丁。别把时间耗在“让旧MATLAB认识新VC”上。

2.4 配置验证与常见报错

配置完成后，验证方法是执行一条简单的C代码编译测试。先写一个测试M文件：

function [s] = hellocompiler() s = 'hello';

然后运行：

mcc -m hellocompiler.m

如果没有任何报错且当前目录生成了hellocompiler.exe，说明环境正常。常见报错有三种：一是“No supported compiler was found”，对应没装任何C编译器或未被识别，用Lcc或换VC版本；二是“The file 'mbuild.bat' was not found”，说明Compiler组件没装全，需要重装组件；三是“Error: Could not find the MCR directory”，说明安装路径含中文或空格，MATLAB在某些版本会处理不好，把路径改成纯英文再试。

表：mbuild配置检查点

上面这个表是我的经验总结，每次换机器或换MATLAB版本时，我都会按这个顺序排查一遍，能省掉很多“编译几十个文件后冒出一堆错误”的麻烦。

注意：mbuild -setup与mex -setup是两回事，前者用于独立应用程序和库生成，后者用于MEX扩展。不要混用。

3. 用mcc把M文件编译成C/C++代码与独立EXE

3.1 mcc的基本语法与参数

mcc是MATLAB Compiler的命令行入口。最常见的几种用法：

mcc -m main.m func1.m func2.m # 生成独立可执行文件，main为入口 mcc -W cpplib:mylib -T link:lib myfun.m # 生成C++共享库 mcc -t -l tstmcc.m # 生成C语言代码和头文件 mcc -m main.m -o mrank_main # 用-o指定输出文件名

参数含义：-m表示编译成可在MATLAB运行时上执行的独立程序（Windows下为exe）；-o指定输出文件名，不写时默认取第一个M文件名；-t是让mcc生成C语言转换代码（旧版本选项，现在多被-W coder替代，但在7.x里仍然有效）；-l在旧版本中表示生成共享库，与-t连用时输出C源代码和头文件。-W cpplib和-T link:lib组合用于生成C++库，适合嵌入到其他工程。如果希望生成C++代码而不是C代码，可以用-W cpp搭配-T codegen，但不同MATLAB版本差异较大，建议先查看help mcc。

需要说明的是，mcc生成的C/C++代码不是给人读的算法实现，而是调用MATLAB C/C++ Library的桥接层。真正的计算逻辑被编译进libmwmllib等库里，所以代码里全是mwArray之类的类型。这不影响使用，反而保证了数值精度与MATLAB完全一致。

3.2 可以被编译的M文件：必须是function开头

这是整个编译过程里最容易踩的坑。如果M文件不是一个函数，而是一段脚本（script），直接编译会报：

... is a script M-file and cannot be compiled with the current Compiler.

mcc只能处理以function关键字开头、有输入输出定义的M文件。这里有个很隐蔽的细节：文件名必须与函数名一致，且function后的输出参数和输入参数要与调用处匹配。我一般会在保存文件后，用which tstmcc确认MATLAB找到了正确的路径，避免因为当前目录在搜索路径之外而编译到旧文件。

另外，脚本M文件可以改写成无参函数。比如你想编译一个读取文件并画图的脚本，就把a=10; plot(a);包成function runme() a=10; plot(a); end，调用时用runme()。

3.3 实例：将FFT计算转成C代码

我们用一个最小例子来演示。在MATLAB编辑器中新建tstmcc.m：

function [yfft] = tstmcc() % 测试：将1x5向量补零到100点后做FFT y = [1, 2, 3, 5, 8]; yfft = fft(y, 100); end

这里fft(y,100)表示在y后面补零至100点再计算100点FFT。保存后，在命令窗口执行：

mcc -t -l tstmcc.m

执行完毕后，当前目录下会生成tstmcc.c、tstmcc.h以及一些辅助文件（如tstmcc_mcc_component_data.c）。tstmcc.c是转换后C语言代码的入口，tstmcc.h声明了对mlfTstmcc函数的接口。如果要用独立exe方式编译，则改为：

mcc -m tstmcc.m

这时得到tstmcc.exe，双击或命令行运行它会输出100点FFT结果。用-o可以改名字：

mcc -m tstmcc.m -o myfft

生成myfft.exe。注意-o后面不要加.exe后缀，mcc会自动加上。

3.4 编译产物的构成

不同版本的mcc生成的产物略有差别。以Matlab 7.x为例，mcc -m执行后，目录下可能出现：

可以看到，-t -l和-m的产物不同。-m侧重可执行程序，-t -l侧重生成C代码供二次开发。如果你想把转换后的C代码用VC编译成自己的exe，那选择-t -l更好，因为它给你提供了可直接加入工程的.c和.h。但要注意，生成的C代码依赖MATLAB运行时库的导入库（比如libmex.lib、libmwmath.lib），需要在VC工程里手工添加这些库的路径。这也是很多人最终改用Matcom的原因——mcc生成的C代码很难直接“拿走就用”，库依赖太多。

注意：-t -l生成的代码仍然需要链接到MATLAB运行库，不是纯C实现。如果目标机器不想装MCR，请考虑第5章的Matcom方案。

3.5 调试技巧：从报错信息判断问题

编译报错时，先看是MATLAB语法错误还是mcc错误。如果是??? Function 'mcc' not found，说明Compiler组件没装；如果是Unable to recognize the extension，说明M文件名非法；如果报Attempt to execute SCRIPT ... as a function，一定是函数名与文件名不匹配或脚本未封装。还有一类错误是M文件里使用了eval、load带变量文件名、动态函数名等，mcc基于静态分析，这些运行时动态特性无法编译，需要重写为静态调用。例如把eval(['a=',name])改成switch分支。

4. 脱离Matlab运行：MCR安装、路径配置与附加资源

4.1 找到MCR安装包

编译生成的exe要运行在目标机器上，必须先安装MATLAB Compiler Runtime（MCR）。这个运行时库相当于把MATLAB核心库抽出来，让不装MATLAB的机器也能执行编译产物。安装包的位置在MATLAB安装目录下，比如MATLAB\R2007a\toolbox\compiler\deploy\win32\MCRinstaller.exe；对于7.0之前的版本，名字是mglinstaller.exe。不同版本文件名和路径略有不同，可以在MATLAB命令窗口执行mcrinstaller命令直接返回完整路径：

mcrinstaller

得到路径后，把这个exe拷贝到目标机器上。我一般会在目标机器上先装好VC运行库（VC++ Redistributable），因为MCR本身也依赖微软的C运行时，避免后续执行exe时弹出缺少msvcr*.dll。

4.2 安装MCR并配置环境变量

安装MCR时，注意记录安装目录，默认是C:\Program Files\MATLAB\MATLAB Component Runtime。安装完成后，需要把MCR的运行时目录加到系统环境变量PATH中。以R2007a为例，运行时目录为：

C:\Program Files\MATLAB\MATLAB Component Runtime\v7x\runtime\win32

如果安装目录是D:\MCR，则对应的是D:\MCR\v7x\runtime\win32。配置方法有两种。一种是用Windows图形界面：“我的电脑”右键属性，高级设置，环境变量，在系统变量里选中Path，编辑追加路径，注意用分号隔开。另一种是在命令行临时设置：

set PATH=%~dp0;%PATH%

或永久设置：

[Environment]::SetEnvironmentVariable("Path", [Environment]::GetEnvironmentVariable("Path", "Machine") + ";C:\Program Files\MATLAB\MATLAB Component Runtime\v7x\runtime\win32", "Machine")

配置完成后，最好先重启命令窗口，再执行where mwarray.dll来确认MCR核心库能被找到。找不到时，运行exe会报Unable to load shared library或Error starting MATLAB Component Runtime。

4.3 拷贝编译产物并执行

把编译生成的exe文件和相关的dll以及可能的_ctf文件复制到目标机器同一目录下。这里有一个细节：某些版本还需要将MCLmcr.dll等文件放在exe所在目录或PATH中。最简单的方式是用deploytool打包安装程序，但在老版本里，手动拷贝是默认做法。执行时，在命令窗口进入exe所在目录，然后输入：

myfft.exe

如果程序没有标准输出，可能看不到结果。对于我们的FFT例子，可以在M文件里加disp或fprintf，编译后就能看到命令行输出。如果是图形化程序，注意目标机器需要安装支持的显卡驱动和桌面环境。

常见错误对照：

注意：MCR版本必须与编译时MATLAB版本一致或兼容，跨大版本（如7.0编的程序用R2009的MCR）经常出现初始化失败。

4.4 附加资源（图标、Web页面）的放置方法

如果程序里用到了图标、帮助HTML文档或配置文件，mcc在编译时通常不会把非m文件打包进去。我在实际项目里遇到过程序引用了version.png但运行目录里没有，直接黑图标。处理方法是：先在目标机器上执行一次编译后的exe，让它自动生成一个“程序名_mcr”的文件夹。这个文件夹是MCR缓存目录，里面会有与M文件同名的子目录，把图标、HTML拷贝到该子目录下即可。比如myfft_mcr\matlab\myfft。注意，如果程序修改了这些资源，需要重新拷贝并清除旧的_mcr缓存，否则更改不会生效。

另外，如果程序需要读写本地数据文件，不要把这些文件放在_mcr缓存里，而应放在exe所在目录，并在M代码里用fileparts(mfilename('fullpath'))获取exe真实路径。因为在编译后的运行环境中，pwd可能指向别的位置。

5. 用Matcom v4.5将M文件转换为C++并集成VC6.0

5.1 Matcom的安装前提

Matcom v4.5是个老牌第三方工具，它的思路和mcc完全不同：它会把M文件翻译成真正的C++源代码，而不是调用运行时库，因此生成的代码可以在VC6.0里直接编译成独立程序，运行时依赖小。不过它只支持Matlab语言的一个子集，矩阵运算和部分工具箱函数能转换，绘图和面向对象特性基本不行。安装前提是：机器已装Matlab 7.0以上版本和Microsoft Visual C++ 6.0。安装前需要额外注意，必须在Matlab安装目录下手动建立\MATLAB701\bin\toolbox\matlab\general文件夹，否则Matcom首次运行时会因为找不到这个路径而报错。这个目录是Matcom用来添加Matlab路径的占位目录。

5.2 配置Matcom与Matlab的路径链接

安装完Matcom v4.5后，第一次运行它会自动搜索VC编译器，并要求确认是否检测到MATLAB。如果已经按上述步骤建立了文件夹，可以继续。然后在MATLAB命令窗口执行：

cd c:\matcom45 % 切换到Matcom安装目录 diary mpath.mat % 开始记录日志 matlabpath % 输出当前MATLAB搜索路径 diary off % 结束日志

上面的命令将MATLAB的路径列表保存到mpath.mat中，供Matcom后续使用。同时，要把Matcom的bin目录下的usertype.dat复制到VC6.0的Common\MSDev98\bin目录，这让VC能够识别Matcom自定义的数据类型。

5.3 在VC6.0中加载mvcide.dll工具条

打开VC6.0，选择菜单“Tools -> Customize -> Add-ins and Macro Files”，点击Browse，将文件类型改为Add-in(.dll)，选择C:\matcom45\bin\mvcide.dll文件。如果VC6.0是中文版，路径是“工具 → 定制 → 附加项和宏文件”。加载后，VC界面会多出一个“Visual MATcom”工具条。这一步成功后，你就能在VC6.0里直接打开M文件进行转换。

5.4 使用Visual MATcom转换并编译

在工具条上点击“Open .m File”打开目标M文件，注意同样要求文件是function开头。然后选择生成目标：C++代码或可执行程序。生成C++代码后，可以在VC工程中加入这些源文件进行编译。因为Matcom生成的代码是完整的C++实现，不像mcc那样必须依赖MCR，所以生成的exe拷贝到没有Matlab和MCR的机器上通常也能运行。但要注意，Matcom生成的代码数值精度和MATLAB可能略有差异，尤其是FFT、矩阵求逆这类计算，因为底层数学库实现不同。对于性能敏感的场景，建议用数据对比验证。

表：mcc vs Matcom v4.5 选型对比

5.5 一个建议的混合工作流

我现在的做法是：算法原型在MATLAB里调通，然后优先用mcc -W cpplib生成C++库，为了精度保持一致；如果目标机器不能装MCR、且算法不涉及复杂工具箱，再考虑用Matcom转纯C++。两种工具生成的代码都要做边界测试，比如输入参数为NaN、空矩阵、复数时的行为。对于大型矩阵，Matcom的转换代码可能比mcc的桥接代码更可控，但也更容易在内存分配上出错，建议在VC6.0调试阶段开调试器跟踪mwArray的构造和析构。

本文还有配套的精品资源，点击获取