在 MATLAB 中手动安装 MinGW-w64 编译器的详细教程

好的，这是一个在 MATLAB 中手动安装 MinGW-w64 编译器的详细教程。请注意，自 MATLAB R2020b 起，官方不再直接支持 MinGW-w64，而是推荐使用其内置的安装程序或 Microsoft Visual C++ 编译器。如果你使用的是较新版本的 MATLAB，建议优先尝试内置的编译器安装方式（在命令行输入 mex -setup 并按提示操作）。如果你确实需要或坚持手动安装 MinGW-w64（例如在旧版本 MATLAB 上），请遵循以下步骤：

重要前提：

1. 版本兼容性检查： 首先，强烈建议你查阅你当前使用的 MATLAB 版本官方文档，确认它是否明确支持 MinGW-w64 编译器，以及支持哪个具体版本。不兼容的编译器版本会导致 mex 命令失败。对于较新版本的 MATLAB (R2020b 及以后)，官方文档通常已不再列出对 MinGW-w64 的支持。
2. 备份 PATH： 在进行系统环境变量修改前，建议记录下当前的 PATH 环境变量内容，以便在出现问题时可以恢复。

安装步骤：

1. 下载 MinGW-w64 安装包：

• 访问 MinGW-w64 的官方网站或可靠的镜像站点。一个常用的下载源是 MSYS2（它提供了 MinGW-w64 工具链）或直接从 MinGW-w64 项目页面下载。
• 你需要下载适用于 Windows 的安装程序。常见的选项有：

• MSYS2 安装程序： 下载并安装 MSYS2。安装完成后，你需要使用 MSYS2 的包管理器 (pacman) 来安装 MinGW-w64 工具链。这是目前推荐的方式。
• 预构建的工具链： 也可以下载其他人预构建好的 MinGW-w64 工具链压缩包（如从 SourceForge 或其他可信来源）。选择与你系统架构（32位或64位）匹配的版本，并且务必选择与 MATLAB 兼容的版本（例如，posix 线程模型和 seh 或 sjlj 异常处理模型通常是 Windows 上 MATLAB 需要的，具体取决于你的系统和 MATLAB 版本）。

• 对于 MSYS2 方式：

• 安装 MSYS2。
• 打开 MSYS2 MinGW x64 终端（如果你需要64位编译器）。
• 运行命令更新包数据库：pacman -Syuu（可能需要重复运行直到完全更新）。
• 安装 MinGW-w64 工具链：pacman -S mingw-w64-x86_64-toolchain（安装64位版本）。等待安装完成。
• MSYS2 的 MinGW-w64 工具链通常安装在类似 C:\msys64\mingw64 的目录下。记下这个路径（例如 C:\msys64\mingw64\bin），后续步骤会用到。

• 对于预构建压缩包方式：

• 解压下载的压缩包到一个没有空格和特殊字符的目录。例如 C:\mingw64。
• 记下解压后 bin 文件夹的完整路径（例如 C:\mingw64\bin）。

2. 将 MinGW-w64 添加到系统 PATH 环境变量：

• 这一步是让 MATLAB（和其他程序）能够找到 gcc, g++ 等编译器命令。
• 右键点击“此电脑”或“我的电脑”，选择“属性”。
• 点击“高级系统设置”。
• 在“系统属性”窗口中，点击“环境变量”按钮。
• 在“系统变量”区域，找到名为 Path 的变量，选中它，点击“编辑”。
• 在“编辑环境变量”窗口中：

• 点击“新建”。
• 输入你之前记录的 MinGW-w64 的 bin 目录的完整路径（例如 C:\msys64\mingw64\bin 或 C:\mingw64\bin）。
• 点击“确定”保存新增的路径。

• 重要： 确保新添加的路径位于包含其他编译器（如 Microsoft Visual Studio）路径的上方，或者确保没有冲突的编译器路径存在。
• 点击“确定”关闭所有打开的窗口。

3. 验证系统 PATH 设置：

• 打开一个新的命令提示符（cmd.exe）。
• 输入 gcc --version 并按回车。
• 如果设置成功，你应该能看到 GCC 的版本信息输出，并且这个版本应该与你下载安装的 MinGW-w64 版本一致。这表明系统已经能在命令行中找到 GCC。
• 同样，输入 g++ --version 和 gfortran --version（如果你安装了 Fortran）进行验证。

4. 在 MATLAB 中配置 MEX：

• 启动 MATLAB。
• 在 MATLAB 命令窗口中，输入以下命令：

mex -setup

• 
• MATLAB 会搜索可用的编译器。
• 如果它找到了你安装的 MinGW-w64 编译器，它应该会列出它（描述中可能包含类似 MinGW64 Compiler 的字样）。
• 按照 MATLAB 的提示选择这个 MinGW-w64 编译器作为默认的 mex 编译器。
• 如果 mex -setup 没有自动找到 MinGW-w64：

• 你可能需要尝试使用 -v 选项查看详细搜索过程：mex -setup -v。
• 检查步骤 2 中的 PATH 是否正确添加，是否添加到了系统环境变量（不是用户变量），并且路径拼写无误。
• 确认安装的 MinGW-w64 版本与 MATLAB 兼容。
• 重启 MATLAB 和计算机有时也能解决路径缓存问题。
• 作为最后的手段，你可以尝试手动创建一个编译器选项文件 (mexopts.bat 或 .xml)，但这比较复杂且容易出错，不推荐新手操作。官方通常不提供 MinGW-w64 的现成选项文件了。

1. 测试 MEX 编译：

• 在 MATLAB 中尝试编译一个简单的示例来验证。
• 例如，将以下代码保存为一个名为 timestwo.c 的文件：

#include "mex.h"
void mexFunction(int nlhs, mxArray *plhs[],
                 int nrhs, const mxArray *prhs[])
{
    double *in, *out;
    in = mxGetPr(prhs[0]);
    plhs[0] = mxCreateDoubleMatrix(1, 1, mxREAL);
    out = mxGetPr(plhs[0]);
    *out = 2.0 * (*in);
}

• 
• 在 MATLAB 命令窗口中，导航到保存 timestwo.c 文件的目录。
• 输入编译命令：

mex timestwo.c

• 
• 如果编译成功，你会看到类似 Building with 'MinGW64 Compiler... MEX completed successfully. 的输出，并在当前目录生成一个 timestwo.mexw64（或类似后缀）文件。
• 测试生成的 MEX 文件：

y = timestwo(3)

• 应该输出 y = 6。

常见问题：

• mex -setup 找不到 MinGW-w64： 这是最常见的问题。仔细检查 PATH 环境变量设置是否正确（路径、系统变量、重启）。确认 MinGW-w64 版本与 MATLAB 兼容。
• 编译错误： 如果 mex 命令报错，错误信息通常会给出线索。可能是编译器版本不兼容、缺少必要的库文件、代码本身有问题或者环境变量配置错误。仔细阅读错误信息。
• MATLAB 新版本限制： 再次强调，R2020b 及更新的 MATLAB 版本官方不再支持 MinGW-w64。在这些版本上手动安装成功的可能性较低，即使成功也可能遇到未知问题。强烈建议使用 MATLAB 内置支持的编译器（如 mex -setup 提供的 Microsoft Visual C++ 选项）。

请根据你的实际情况调整路径和版本。如果遇到困难，查阅 MATLAB 官方文档关于 mex 编译器的支持部分通常是解决问题的最佳起点。