Ubuntu系统安装MATLAB全流程详解：从依赖配置到图形界面排错

原创于 2026-08-19 16:40:24 发布 · 397 阅读

本内容遵循CC 4.0 BY-SA版权协议

在 Ubuntu 这类 Linux 发行版上安装 MATLAB，对于从事科学计算、算法开发和工程仿真的研究人员和工程师来说，是一个常见的需求。虽然 MATLAB 官方对 Windows 和 macOS 的支持更为直观，但在 Linux 环境下，尤其是 Ubuntu 上，其安装过程涉及一些特有的步骤和潜在的兼容性问题。许多用户在尝试安装时会遇到依赖缺失、图形界面异常、许可证激活失败或启动器创建困难等情况。本文将从一个实际使用者的角度，详细拆解在 Ubuntu 系统上从下载、安装、配置到验证使用的完整流程，并重点解释每一步背后的原理和可能遇到的坑。通过本文，你将能够独立完成一个可稳定运行的 MATLAB 环境搭建，并了解如何排查安装后常见的图形界面和功能性问题。

1. 理解 MATLAB 在 Linux 环境下的部署特点

在开始动手之前，理解 MATLAB 在 Linux 下的运行机制至关重要，这能帮助你在遇到问题时快速定位。

1.1 为什么在 Ubuntu 上安装 MATLAB 更复杂

MATLAB 本质上是一个大型的、闭源的商业软件套件，它并非通过 Ubuntu 默认的包管理器（如 apt ）来分发。其安装包是一个独立的、包含预编译二进制文件、库文件和帮助文档的归档文件。在 Linux 下，它严重依赖系统的基础库（如 glibc 、 libstdc++ ）和图形库（如 libxcb , OpenGL ）。Ubuntu 的库版本可能与 MATLAB 构建时使用的版本存在差异，导致兼容性问题。此外，Linux 的桌面环境（如 GNOME, KDE）和显示服务器（X11/Wayland）的多样性，也增加了图形界面正常显示的复杂度。

1.2 安装流程概览

一个完整的安装流程可以概括为以下几个核心阶段，后续章节将逐一展开：

环境准备 ：确保系统满足最低要求，并安装必要的依赖库。
获取安装介质 ：从 MathWorks 官网下载适用于 Linux 的 ISO 镜像或安装文件。
执行安装程序 ：挂载镜像，以非图形或图形化方式运行安装脚本。
激活与许可 ：使用文件安装密钥（File Installation Key）或许可证文件完成激活。
创建启动器与环境配置 ：让系统能够方便地找到并启动 MATLAB。
功能验证与问题排查 ：运行 MATLAB，测试基本功能和图形界面，并解决常见错误。

2. 安装前的环境准备与依赖检查

这一步是后续所有操作的基础，准备不充分是安装失败最常见的原因。

2.1 系统要求确认

首先，确认你的 Ubuntu 版本是否被 MATLAB 支持。以 MATLAB R2024b 为例，其官方支持 Ubuntu 22.04 LTS 及 24.04 LTS。你可以通过以下命令查看系统信息：

lsb_release -a

确保你的系统架构是 x86-64（即 64 位）。虽然 ARM 架构（如 Apple Silicon）通过 Rosetta 2 或虚拟机也可运行，但官方支持有限，本文主要讨论 x86-64 原生安装。

2.2 安装必要的系统依赖

MATLAB 的安装程序和运行时需要一系列系统库。在 Ubuntu 上，你可以通过 apt 包管理器一次性安装许多常见依赖。建议在安装前更新软件包列表并安装以下包：

sudo apt update
sudo apt upgrade -y
sudo apt install -y libc6 libstdc++6 libgcc1 libxcb1 libxcb-xinerama0 libxcb-randr0 \
libxcb-shape0 libxcb-xfixes0 libxcb-keysyms1 libxcb-icccm4 libxcb-image0 \
libxcb-render-util0 libxcb-xkb1 libxkbcommon-x11-0 libxkbcommon0 \
libxrender1 libxext6 libx11-6 libxft2 libxinerama1 libxcursor1 \
libxi6 libxt6 libxtst6 libxrandr2 libxss1 libxxf86vm1 \
libgl1-mesa-glx libglu1-mesa libgl1 libgtk-3-0 \
libasound2 libpulse0 libcurl4-gnutls-dev \
unzip p7zip-full

关键解释 ：

libxcb-* 和 libx11-* 系列库是 X Window 系统的基础，负责图形显示。
libgl1-mesa-glx 和 libglu1-mesa 提供 OpenGL 支持，这对 MATLAB 的图形渲染（如 plot , simulink ）至关重要。
libgtk-3-0 是 GTK 图形工具包，MATLAB 的某些 UI 组件依赖它。
unzip 和 p7zip-full 用于解压可能的安装包。
安装这些依赖的目的是尽可能模拟 MATLAB 构建时的库环境，避免运行时出现 “libxxx.so.x: cannot open shared object file” 这类错误。

2.3 获取 MATLAB 安装文件

你需要拥有 MathWorks 账户并持有有效的许可证。登录 MathWorks 官网，进入下载页面，选择目标版本（如 R2024b），然后选择 Linux 平台。通常会提供两种格式：

ISO 镜像文件 ：如 matlab_R2024b_glnxa64.iso 。
压缩包文件 ：如 matlab_R2024b_glnxa64.zip 。

下载完成后，建议验证文件的完整性（如通过 MD5 或 SHA256 校验和），特别是当下载网络不稳定时。

3. 执行 MATLAB 安装程序

根据你下载的文件格式，安装步骤略有不同。

3.1 从 ISO 镜像安装

这是最推荐的方式，因为镜像内包含了完整的文件结构。首先，创建一个用于挂载的目录，并挂载 ISO 文件：

sudo mkdir -p /media/matlab
sudo mount -o loop /path/to/your/matlab_R2024b_glnxa64.iso /media/matlab

其中 /path/to/your/ 替换为你的 ISO 文件实际路径。

然后，切换到挂载目录并启动安装程序。你可以选择图形化安装或非交互式安装。

图形化安装（推荐首次安装） ：

cd /media/matlab
sudo ./install

这会启动一个与 Windows/macOS 上类似的图形安装向导。你需要有图形桌面环境（如 GNOME）并正确设置了 DISPLAY 环境变量。

非交互式安装（适用于脚本或服务器） ：你需要一个 installer_input.txt 文件来预配置安装选项。可以从安装包中复制模板并修改：

cp /media/matlab/installer_input.txt ~/matlab_install_input.txt

编辑此文件，关键参数如下：

destinationFolder=/usr/local/MATLAB/R2024b
fileInstallationKey=你的文件安装密钥
agreeToLicense=yes
outputFile=/tmp/matlab_install.log
mode=silent

然后运行：

sudo ./install -inputFile ~/matlab_install_input.txt

3.2 从压缩包安装

如果下载的是 ZIP 文件，解压后其内部结构通常与 ISO 挂载后的内容一致。

unzip /path/to/matlab_R2024b_glnxa64.zip -d /tmp/matlab_install
cd /tmp/matlab_install
sudo ./install

后续步骤与从 ISO 安装相同。

3.3 安装过程中的关键选择

在图形化安装向导中，以下几个步骤需要特别注意：

选择安装类型 ：通常选“使用文件安装密钥”，这需要你从 MathWorks 账户获取的一串数字密钥。
选择许可证文件 ：如果你有 license.lic 文件，可以在相应步骤选择。也可以在安装完成后激活。
选择安装路径 ：默认是 /usr/local/MATLAB/R2024b 。确保目标路径有足够的磁盘空间（通常需要 20-30 GB）和写入权限。不建议安装在用户主目录下，除非是单用户环境。
选择产品 ：默认会安装所有已授权的工具箱。你可以取消勾选暂时不需要的工具箱以节省空间和时间。
创建符号链接 ：建议勾选“创建符号链接”，这会在 /usr/local/bin 下创建一个指向 MATLAB 启动脚本的链接，方便命令行启动。

4. 激活、许可与启动器配置

安装完成后，MATLAB 可能还未激活，或者系统无法方便地找到它。

4.1 激活 MATLAB

如果你在安装时未完成激活，首次启动 MATLAB 时会弹出激活向导。你需要：

在线激活 ：输入 MathWorks 账户和密码。
离线激活 ：选择“不使用互联网手动激活”，并按照提示生成激活文件，然后在 MathWorks 许可证中心上传该文件获取 license.lic ，最后将其放入 MATLAB 的激活目录（通常是 $MATLAB_ROOT/licenses/ ）。

4.2 创建桌面启动器与命令行快捷方式

虽然安装程序可能创建了菜单项，但有时会失败。手动创建可以确保稳定性。

创建桌面启动器文件 ( ~/.local/share/applications/matlab.desktop )：

[Desktop Entry]
Type=Application
Name=MATLAB R2024b
Comment=启动 MATLAB
Exec=/usr/local/MATLAB/R2024b/bin/matlab -desktop
Icon=/usr/local/MATLAB/R2024b/toolbox/shared/dastudio/resources/MatlabIcon.png
Terminal=false
Categories=Development;Science;Math;
StartupWMClass=com-mathworks-util-PostVMInit

保存后，你可能需要运行 update-desktop-database ~/.local/share/applications 来更新数据库。

创建命令行快捷方式 ：安装时创建的符号链接（如 /usr/local/bin/matlab ）应该已经存在。如果没有，可以手动创建：

sudo ln -s /usr/local/MATLAB/R2024b/bin/matlab /usr/local/bin/matlab

现在，你可以在终端中直接输入 matlab 来启动 MATLAB 桌面，或使用 matlab -nodesktop -nosplash 启动无桌面环境的命令行版本。

4.3 环境变量配置（可选但重要）

某些情况下，你可能需要设置环境变量来调整 MATLAB 的行为。可以将以下内容添加到你的 shell 配置文件（如 ~/.bashrc 或 ~/.zshrc ）中：

# 设置 MATLAB 根目录
export MATLAB_ROOT=/usr/local/MATLAB/R2024b
# 将 MATLAB 可执行文件目录加入 PATH（如果符号链接未生效）
export PATH=$MATLAB_ROOT/bin:$PATH
# 解决某些图形或字体问题
export MATLAB_JAVA=/usr/lib/jvm/java-11-openjdk-amd64  # 指向你的 Java 路径
export MATLAB_USE_WAYLAND=0  # 如果使用 Wayland 显示服务器且有问题，强制使用 X11

修改后，执行 source ~/.bashrc 使配置生效。

5. 运行验证与核心功能测试

安装并配置完成后，必须进行系统性测试，而不仅仅是看程序能否启动。

5.1 基础启动测试

在终端中运行：

matlab -nodesktop -nosplash -r "disp('MATLAB is working'); exit"

这行命令会以无桌面模式启动 MATLAB，显示一条信息，然后退出。如果看到输出 MATLAB is working ，说明核心解释器工作正常。

5.2 图形界面与绘图测试

启动完整的 MATLAB 桌面环境：

matlab -desktop

等待启动后，在命令窗口（Command Window）中执行以下测试：

基本运算 ： 2+2 ，应返回 4 。
图形绘制 ：
```
figure;
plot(1:10, rand(1,10), 'r-o');
title('Test Plot');
xlabel('X');
ylabel('Y');
```
这应该弹出一个新的图形窗口，显示一条带红色圆点的随机折线。如果图形窗口空白、闪退或报错，通常是图形库（OpenGL）或显示设置问题。
工具箱函数测试 ：测试你安装的关键工具箱。例如，安装了统计工具箱，可以测试：
```
data = normrnd(0, 1, [100, 1]); % 生成正态分布随机数
[h, p] = ttest(data); % 进行单样本 t 检验
disp(['t-test p-value: ', num2str(p)]);
```
这可以验证 normrnd 和 ttest 函数是否可用。

5.3 Simulink 测试（如已安装）

在命令窗口输入 simulink 并回车。Simulink 库浏览器应能正常打开。尝试新建一个模型，拖入一个 Sine Wave 模块和一个 Scope 模块，连接并运行仿真，查看 Scope 是否显示正弦波。

6. 常见问题与深度排查指南

在 Ubuntu 上运行 MATLAB，以下问题是高发区。这里提供从现象到根因的排查路径。

6.1 图形界面相关问题

问题现象	可能原因	检查与解决方案
启动 `matlab -desktop` 后闪退或无响应	1. 缺少关键图形库依赖。 2. OpenGL 驱动问题。 3. Wayland 兼容性问题。	1. 重新运行第 2.2 节的依赖安装命令。 2. 检查 OpenGL：运行 `glxinfo \| grep “OpenGL version”` 。确保有输出且版本较新。对于 NVIDIA 显卡，确保安装了专有驱动 ( `sudo apt install nvidia-driver-550` )。 3. 尝试强制使用 X11：启动时加参数 `matlab -softwareopengl` ，或设置环境变量 `export MATLAB_USE_WAYLAND=0` 并切换到 X11 会话登录。
图形窗口空白、花屏或渲染异常	OpenGL 渲染器选择不当或驱动有 bug。	1. 在 MATLAB 命令窗口运行 `opengl info` ，查看当前使用的渲染器。 2. 尝试切换渲染器： `opengl software` 切换到软件渲染，或 `opengl hardware` 切回硬件渲染。 3. 在启动时指定： `matlab -desktop -softwareopengl` 。
字体显示异常、太小或方块	字体路径配置问题或缺少字体。	1. 在 MATLAB 中，通过 `主页` -> `环境` -> `预设` -> `字体` 调整代码和桌面字体。 2. 确保系统安装了核心字体： `sudo apt install fonts-dejavu-core` 。 3. 链接系统字体到 MATLAB： `sudo ln -s /usr/share/fonts /usr/local/MATLAB/R2024b/sys/fonts` (谨慎操作，备份原目录)。

6.2 启动与库依赖问题

问题现象	可能原因	检查与解决方案
启动时报错： `libxxx.so.x: cannot open shared object file`	缺少特定的系统共享库。	1. 复制错误信息中的库文件名（如 `libicuuc.so.60` ）。 2. 使用 `apt-file` 查找提供该库的包： `sudo apt install apt-file && sudo apt-file update && apt-file search libicuuc.so.60` 。 3. 安装对应的包： `sudo apt install libicu60` 。
安装程序 `./install` 无法启动或报错	1. 安装文件权限问题。 2. 缺少安装程序自身的依赖（如 Java）。	1. 确保安装文件有执行权限： `chmod +x /media/matlab/install` 。 2. 确保系统安装了 Java： `java -version` 。MATLAB 安装程序通常需要 Java 8 或 11。可安装 `openjdk-11-jre` 。
许可证错误： `License Manager Error -xx`	1. 许可证文件损坏或路径错误。 2. 网络许可证服务器不可达。 3. 主机ID（MAC地址）变更。	1. 检查许可证文件路径： `$MATLAB_ROOT/licenses/license.lic` ，确保内容正确。 2. 对于网络许可证，检查 `$MATLAB_ROOT/licenses/network.lic` 中的服务器地址和端口是否可达。 3. 运行 `lmutil lmhostid` (位于 `$MATLAB_ROOT/etc` 或 `$MATLAB_ROOT/bin/glnxa64` ) 查看当前主机ID，与许可证文件中的 `HOSTID=` 字段比对。

6.3 功能与性能问题

问题现象	可能原因	检查与解决方案
某些工具箱函数无法识别（如 `函数或变量 ‘deltalin’ 无法识别` ）	1. 该函数所属工具箱未安装。 2. 函数名拼写错误。 3. 该函数属于第三方工具箱或已更名。	1. 使用 `ver` 命令查看已安装的工具箱列表，确认对应工具箱是否存在。 2. 使用 `which functionName` 查找函数路径，或 `help functionName` 查看帮助。 3. 查阅对应版本的 MATLAB 文档，确认函数名和所属工具箱。
MATLAB 运行速度慢，特别是绘图时	1. 使用了软件 OpenGL 渲染。 2. 系统资源不足。 3. MATLAB 版本与系统兼容性不佳。	1. 如前所述，尝试切换到硬件 OpenGL ( `opengl hardware` )。 2. 监控系统资源使用： `htop` 。 3. 考虑使用更新的 MATLAB 版本，其对新的 Linux 内核和硬件支持更好。
无法读取/写入用户目录外的文件	安装时以 `sudo` 运行，导致文件权限归属 root。	修正 MATLAB 安装目录下文件的所有权，使其对当前用户可写： `sudo chown -R $USER:$USER /usr/local/MATLAB/R2024b` 。注意，这可能有安全风险，仅适用于个人开发机。

7. 生产环境考量与最佳实践

如果你计划在服务器、集群或长期开发环境中使用 MATLAB，以下实践能提高稳定性和可维护性。

7.1 版本管理与多版本共存

有时需要同时安装多个 MATLAB 版本。每个版本应安装在不同的目录（如 /usr/local/MATLAB/R2024a , /usr/local/MATLAB/R2023b ）。可以通过修改环境变量 PATH 或使用不同的启动脚本来切换版本。一个更灵活的方式是使用模块系统（如 environment-modules ）或创建版本管理脚本。

7.2 无头模式（Headless）运行与自动化

在服务器上，通常不需要图形桌面。使用 -nodisplay 、 -nodesktop 和 -nosplash 参数可以显著减少资源占用并避免图形依赖问题。

matlab -nodisplay -nosplash -r “your_script_name; exit”

对于批处理作业，可以将 MATLAB 命令写入 .m 脚本文件，然后通过上述命令调用。结合 cron 或作业调度系统（如 Slurm）可以实现自动化计算。

7.3 资源限制与监控

长期运行或处理大型数据的 MATLAB 进程可能消耗大量内存和 CPU。

内存：MATLAB 默认会预分配内存。对于有限内存的服务器，可以在启动时使用 -maxHeapSize 参数限制堆大小，或在代码中注意清理大变量（ clear ）和使用高效的数据结构。
CPU ：MATLAB 的许多计算函数（如矩阵运算）会自动多线程并行。可以通过 maxNumCompThreads 函数在代码中控制使用的核心数，避免干扰同一服务器上的其他任务。
磁盘 I/O ：频繁读写文件会降低性能。考虑使用内存映射文件（ memmapfile ）或优化读写逻辑。

7.4 定期维护与更新

系统更新后 ：Ubuntu 系统大版本升级或关键库更新后，可能导致 MATLAB 依赖的库版本不兼容。在升级前，最好在测试环境中验证 MATLAB 的兼容性。
MATLAB 更新 ：MathWorks 会发布补丁更新。可以通过 MATLAB 内的“附加功能”->“检查更新”来获取，或在官网下载更新包手动安装。
许可证维护 ：注意许可证的到期时间。对于浮动网络许可证，确保许可证服务器稳定运行。

7.5 备份与恢复策略

对于重要的 MATLAB 工作环境（包括安装目录、自定义工具箱、预设文件 prefdir 下的内容），应建立备份。

安装目录 ：整个 /usr/local/MATLAB/R2024b 目录可以打包备份。恢复时解压到相同路径，并重新创建符号链接和启动器即可。
用户配置 ：用户特定的配置、历史记录、工作区布局保存在 ~/.matlab/R2024b/ 目录下。定期备份此目录可以在重装系统后快速恢复个人设置。
项目代码与数据 ：务必使用版本控制系统（如 Git）管理你的 .m 、 .slx 等代码文件，数据文件也应定期备份到安全位置。

通过遵循上述从准备、安装、验证到排错和优化的完整流程，你可以在 Ubuntu 系统上建立一个稳定、高效的 MATLAB 开发和计算环境。关键在于理解其与系统底层的交互，并在遇到问题时，能够系统地检查依赖、图形、许可和配置这几个核心环节。

标签