在 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 libstdc6 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你的文件安装密钥 agreeToLicenseyes outputFile/tmp/matlab_install.log modesilent然后运行sudo ./install -inputFile ~/matlab_install_input.txt3.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] TypeApplication NameMATLAB R2024b Comment启动 MATLAB Exec/usr/local/MATLAB/R2024b/bin/matlab -desktop Icon/usr/local/MATLAB/R2024b/toolbox/shared/dastudio/resources/MatlabIcon.png Terminalfalse CategoriesDevelopment;Science;Math; StartupWMClasscom-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_WAYLAND0 # 如果使用 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中执行以下测试基本运算22应返回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_WAYLAND0并切换到 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. 链接系统字体到 MATLABsudo 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. 确保系统安装了 Javajava -version。MATLAB 安装程序通常需要 Java 8 或 11。可安装openjdk-11-jre。许可证错误License Manager Error -xx1. 许可证文件损坏或路径错误。2. 网络许可证服务器不可达。3. 主机IDMAC地址变更。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和使用高效的数据结构。CPUMATLAB 的许多计算函数如矩阵运算会自动多线程并行。可以通过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 开发和计算环境。关键在于理解其与系统底层的交互并在遇到问题时能够系统地检查依赖、图形、许可和配置这几个核心环节。