Ubuntu 20.04安装MATLAB R2023b常见报错与解决指南

在Ubuntu 20.04上装MATLAB R2023b说难不难但说顺利也真不算顺利。我前后给实验室几台不同配置的机器装过加上帮群里网友远程排查过的各种奇奇怪怪的报错基本都撞了一遍。这篇文章就专门梳理安装过程中最常见的坑和对应的解决办法包括安装器起不来、依赖库缺失、激活失败、启动崩溃、中文显示乱码这类高频问题照着操作基本能一次走通。先说一下适用场景系统是Ubuntu 20.0420.04.x都行要装的是R2023b安装包是官方ISO镜像或者从学校/单位License中心下载的版本。如果你的环境是Ubuntu 22.04或者24.04部分依赖库的包名会有差异下文我会顺带标注。1. 安装前的准备工作与常见认知误区很多人在安装环节就卡住其实根本不是安装器有问题而是准备工作没做到位。这一节先把最容易踩的坑说清楚。1.1 确认系统环境与版本匹配先说一个很多人忽略的点MATLAB R2023b官方支持的是Ubuntu 20.04以及22.04但有些人的Ubuntu 20.04是精简版、服务器版或者自己裁剪过的缺少很多桌面组件和基础库这会导致安装器界面无法显示或者安装到一半报各种古怪错误。我建议安装前先确认几件事系统版本lsb_release -a架构uname -m输出一般是x86_64MATLAB R2023b目前对ARM架构支持有限如果你在树莓派或者ARM云服务器上装需要确认是否属于官方支持范围磁盘空间MATLAB完整安装大概需要25~30GB加上临时解压空间建议预留至少40GB内存建议8GB以上4GB也能跑但安装过程会明显变慢另外如果你是虚拟机VMware、VirtualBox装的Ubuntu 20.04建议给虚拟机分配至少2核CPU和8GB内存否则安装器响应很慢容易让人误以为卡死了。1.2 安装文件获取与ISO挂载的正确姿势R2023b的安装包一般是ISO镜像大小大约20GB左右。很多人下载完之后直接双击ISO在GNOME桌面环境下确实能自动挂载但有时候挂载后看不到内容这时候需要手动挂载。手动挂载的命令很简单sudo mkdir -p /mnt/matlab sudo mount -o loop /path/to/R2023b.iso /mnt/matlab注意-o loop参数这是加载镜像文件为块设备的关键不加这个会报mount: /mnt/matlab: wrong fs type, bad option, bad superblock。如果遇到这个报错基本就是loop参数的问题。挂载完成后你会看到/mnt/matlab下有一个install文件这就是安装器的启动脚本。很多人直接双击运行但权限不够会导致脚本执行失败推荐用命令行方式启动安装器。另外提一句挂载ISO后如果系统自动弹出一个文件管理器窗口不用管它我们真正需要的是那个install可执行文件。安装完成后记得卸载ISOsudo umount /mnt/matlab1.3 该装哪些依赖包提前装好省得后面抓狂这是我最想强调的一点。MATLAB的安装器和MATLAB本体依赖一批系统库如果缺了安装时可能表现不明显但启动时各种崩溃就来了。我踩过的坑包括缺libxt6安装器能打开但点击“Next”后直接闪退缺libxrender1安装过程中进度条卡在19%然后报错缺libcrypt1MATLAB启动时提示error while loading shared libraries: libcrypt.so.1下面这条命令基本覆盖了R2023b在Ubuntu 20.04上需要的主要依赖库建议在安装前就执行sudo apt update sudo apt install -y libxt6 libxrender1 libxtst6 libxi6 libgl1-mesa-glx libglu1-mesa libgomp1 libcrypt1 libncurses5 libncurses6 libfreetype6 libfontconfig1 xterm如果系统提示libgl1-mesa-glx找不到可以换成libgl1Ubuntu 20.04的仓库里两个都存在有些精简源只有新版本。这里还推荐直接安装matlab-support这个包它是Ubuntu社区维护的MATLAB辅助工具会自动帮你配置很多系统层面的东西sudo apt install matlab-support安装过程中它会问你MATLAB安装路径如果还没安装可以随便填一个后面用dpkg-reconfigure matlab-support重新配置即可。2. 安装过程高频报错与解决方案准备工作做完了接下来进入安装环节。这一节的报错都是我实际遇到或者帮别人排查过的按频率排序。2.1 图形界面启动失败三种原因一次说透安装器启动命令是cd /mnt/matlab sudo ./install但很多人会遇到界面根本出不来终端也没报错就是卡在那里。我总结下来原因基本是这三种第一种缺少图形库。这对应上面提到的libxt6、libxrender1缺失。判断方法很简单在终端里运行ldd /mnt/matlab/bin/glnxa64/MathWorksProductInstaller | grep not found如果输出里有not found字样的库装对应的包就行。第二种Java运行时有问题。MATLAB R2023b的安装器自带Java运行时理论上不需要系统装Java但如果你系统里装了不兼容的Java版本比如Java 17以上的OpenJDK可能会干扰安装器启动。保险做法是启动安装器时指定使用自带JREcd /mnt/matlab sudo ./install -javadir /mnt/matlab/sys/java/jre/glnxa64第三种权限问题。把ISO挂载在/mnt下普通用户对挂载目录没有执行权限会导致安装器启动失败。这里有两种解法一是用sudo运行安装器二是给目录加上执行权限。另外需要注意的是安装目标目录比如/usr/local/MATLAB也需要足够的写权限。如果你不想用sudo安装也可以把ISO文件拷贝到用户目录下再接挂载然后直接运行./install这样整个过程都在用户权限下完成。不过我个人还是建议装在/usr/local/MATLAB这种系统目录后续配置哪个用户都能用。2.2 “无法读取安装文件”的排查思路安装过程中弹出Cannot read the installation files或者类似的错误提示基本可以锁定两个方向ISO镜像损坏或下载不完整。R2023b完整ISO大小约19GB很多人用下载工具断点续传结果文件校验不对。这时需要对比官方SHA256校验和sha256sum /path/to/R2023b.iso把输出的哈希值和MathWorks官网公布的对比不一致就重新下载。挂载后无法读取文件权限。如果校验和没问题检查一下挂载点权限ls -la /mnt/matlab/install如果显示权限只有r--r--r--说明这个文件不可执行重新挂载时加上exec选项sudo mount -o loop,exec /path/to/R2023b.iso /mnt/matlab这里有个细节mount默认情况下如果文件系统被标记为noexec即使文件有x权限也无法执行。一次性挂载时明确指定exec最省事。2.3 安装进度卡住不动如何判断是死是活MATLAB安装进度条卡在某个百分比不动是最让人焦虑的情况。我遇到过卡在19%、54%、78%三种位置原因各不相同卡在19%左右大概率是磁盘空间不足。可以通过df -h /usr/local查看目标分区剩余空间卡在54%左右一般是正在安装Toolbox这个过程比较长是正常的特别是选了全部工具箱的情况下安静等十几分钟都正常卡在78%左右通常是正在注册文件关联和更新系统缓存也是正常的判断安装器是否还活着有个很实用的方法开一个终端输入top或者htop查看是否有install和java相关进程在消耗CPU。如果CPU占用一直在跳动说明还在正常工作耐心等就行。如果CPU完全没有占用那就是真卡死了可以尝试直接关掉安装器重新来过。注意重新安装前最好删除/tmp下的临时文件rm -rf /tmp/*mathworks*这个坑我踩过第一次安装失败后第二次安装老报错就是残留的临时文件在作祟。3. 激活与许可最容易出问题的环节安装本体完成之后真正的考验才开始。R2023b的激活环节绝对是问题重灾区我这边收集到的报错至少有一半发生在这个阶段。3.1 许可证文件放置位置与权限用学校或单位License激活时最常见的问题是许可证文件路径不对或者权限不足。R2023b的许可证文件需要放在$MATLAB_ROOT/licenses目录下比如sudo cp /path/to/license.lic /usr/local/MATLAB/R2023b/licenses/ sudo chmod 644 /usr/local/MATLAB/R2023b/licenses/license.lic很多人直接把许可证文件放在下载目录然后启动MATLAB时手动指向它这样也可以但每次启动都要重新指定路径很不方便。放在安装目录下最省心MATLAB启动时会自动搜索。权限这里有个大的坑如果许可证文件权限是600或者属主不对MATLAB以普通用户启动时会提示Unable to read license file。这个报错误导性很强很多人以为是许可证过期了其实是文件根本读不了。另外要注意如果许可证文件是从Windows上拷贝过来的可能带着Windows换行符CRLF可能会导致激活失败。处理方式sudo sed -i s/\r$// /usr/local/MATLAB/R2023b/licenses/license.lic3.2 联网激活失败的三种处理方式如果你用的是个人版LicenseMathWorks账户激活时需要联网。常见的激活失败场景和解决办法场景一激活时提示无法连接MathWorks服务器。大多数原因是网络代理问题。如果你在校园网或者公司网络环境下需要配置代理export http_proxyhttp://your-proxy:port export https_proxyhttp://your-proxy:port然后重新运行激活程序/usr/local/MATLAB/R2023b/bin/activate_matlab.sh场景二DNS解析异常。访问不了mathworks.com试试修改DNS或者挂代理。临时修改DNS的命令sudo sh -c echo nameserver 8.8.8.8 /etc/resolv.conf不过这个修改重启后会丢失建议只在激活时临时用。场景三防火墙拦截。Ubuntu默认没有开防火墙但如果你装了ufw并且启用了需要放行MATLAB相关端口sudo ufw allow out 443/tcp sudo ufw allow out 80/tcp大多数情况下激活失败都是网络配置问题不是License本身的问题。我建议在激活前先用浏览器或者curl测试一下能不能访问MathWorks官网curl -I https://www.mathworks.com如果返回200 OK说明网络是通的。3.3 安装完成后重新激活的操作要点有时候激活过程一闪而过或者中间报错了但MATLAB已经装完了。这时候不需要重新走一遍安装流程直接执行激活脚本即可。R2023b的激活脚本路径是/usr/local/MATLAB/R2023b/bin/activate_matlab.sh这个脚本默认带图形界面如果没有图形环境或者界面起不来可以用命令行方式指定许可证/usr/local/MATLAB/R2023b/bin/activate_matlab.sh -activate -licensefile /path/to/license.lic另一个常见的做法是直接编辑/usr/local/MATLAB/R2023b/licenses/license.dat文件在文件顶部添加SERVER hostname mac-address 27000 USE_SERVER然后把你的许可证文件放在同一目录下。这种方式适合网络浮动License的情况。4. 启动与运行时的坑安装和激活都搞定了以为万事大吉结果双击图标或者输入matlab命令后各种问题又来。这一节全是实战经验。4.1 启动即崩溃的常见原因输入matlab命令后终端刷了一堆日志然后退出或者界面刚出现就闪退是特别常见的问题。排查思路按顺序来第一步看启动日志。MATLAB会把启动日志写到/home/用户名/.matlab/R2023b目录下关键文件是matlab.log和java.log。用下面命令查看结尾部分tail -50 ~/.matlab/R2023b/matlab.log第二步检查GPU驱动。这是我的血泪教训。MATLAB R2023b默认会启用硬件OpenGL加速如果你的显卡驱动没有装好或者安装的是NVIDIA闭源驱动但版本不匹配MATLAB界面会在启动时闪退。最直接的解决办法是禁用OpenGL硬件加速export MATLAB_USE_USER_OPENGL1 # 或者更彻底一点 export MATLAB_DISABLE_GRAPHICS0如果还是不行试试用软件渲染方式启动matlab -softwareopengl这个选项强制MATLAB用软件渲染性能会差一些但能保证界面稳定显示。如果-softwareopengl能正常启动基本可以断定就是GPU驱动问题。可以检查一下自己的显卡驱动nvidia-smi如果输出command not found说明NVIDIA驱动没装好需要单独解决。这里顺便提一句Ubuntu 20.04上安装NVIDIA驱动比较稳妥的方式是通过Software Updates的Additional Drivers选项卡或者用ubuntu-drivers autoinstall命令不建议自己从NVIDIA官网下载run文件容易把系统搞坏。第三步查看缺失的共享库。终端运行ldd /usr/local/MATLAB/R2023b/bin/glnxa64/MATLAB | grep not found如果有缺失项按缺失库名安装对应包。4.2 字体与中文显示问题MATLAB在Linux下的字体渲染一直是个槽点。R2023b在Ubuntu 20.04上常见的字体问题有字体比例失调界面按钮、菜单文字挤成一团。这是因为缺了MATLAB自带的某些字体或者系统没有xfonts-100dpi这一类位图字体。解决方式sudo apt install xfonts-100dpi xfonts-75dpi sudo dpkg-reconfigure fontconfig重装字体缓存sudo fc-cache -f -v中文注释乱码编辑器里中文注释显示成方块或者问号。MATLAB默认字体不支持中文字符需要在Home选项卡里把编辑器字体改成支持中文的比如Noto Sans CJK SC或者WenQuanYi Micro Heisudo apt install fonts-noto-cjk fonts-wqy-microhei设置路径Home - Preferences - Fonts - Desktop code font选一个中文字体。改完之后重启MATLAB生效。命令行输出中文乱码这个问题经常出现在终端直接运行MATLAB脚本时跟终端本身的locale设置有关。解决方式export LANGen_US.UTF-8 export LC_ALLen_US.UTF-8或者干脆用LANGzh_CN.UTF-8也行关键是要保证locale存在locale -a | grep UTF-8如果输出为空需要先生成localesudo locale-gen en_US.UTF-84.3 缺少lib库文件导致的功能异常安装完MATLAB之后有可能本体能启动但某些工具箱功能报错提示找不到.so文件。这是因为MATLAB工具箱的一些组件依赖系统库例如安装Simulink后仿真报错libmwbinder.so: cannot open shared object file使用Parallel Computing Toolbox时提示libcudart.so找不到这类问题的通用解决思路是用find定位缺失库文件是否存在find /usr/local/MATLAB/R2023b -name libcudart.so*如果找不到说明对应组件没装全需要重新运行安装器并选择“添加工具箱”。如果库文件存在但系统找不到需要设置环境变量export LD_LIBRARY_PATH/usr/local/MATLAB/R2023b/bin/glnxa64:$LD_LIBRARY_PATH把这一行加到~/.bashrc末尾然后source ~/.bashrc一劳永逸。这里再说一个比较偏门但很实际的问题libstdc.so.6版本冲突。MATLAB R2023b是Ubuntu 20.04时代发布的编译时用的GCC库版本较老如果你的系统安装了新版GCC开发包可能导致MATLAB加载到新版本的libstdc而出现诡异的崩溃。遇到这种情况可以用LD_PRELOAD强制指定老版本库。但这种情况比较少见一般出现在你额外装了Anaconda或者其他包含自带库的软件之后。Anaconda的lib目录会和MATLAB的库冲突解决办法是在启动MATLAB前把Anaconda从PATH里去掉。4.4 命令行启动与快捷方式配置安装完成后默认执行matlab命令可能会提示command not found这是因为可执行文件没有在PATH路径里。解决方式很简单创建软链接sudo ln -s /usr/local/MATLAB/R2023b/bin/matlab /usr/local/bin/matlab这样在任意目录输入matlab就能启动。如果不想用软链接也可以直接编辑~/.bashrc在末尾加一行export PATH$PATH:/usr/local/MATLAB/R2023b/bin然后source ~/.bashrc接下来是一个很多新手容易卡住的地方创建桌面快捷方式方便双击启动。在~/.local/share/applications下创建一个matlab.desktop文件nano ~/.local/share/applications/matlab.desktop内容如下[Desktop Entry] Version1.0 TypeApplication NameMATLAB R2023b CommentStart MATLAB R2023b Exec/usr/local/MATLAB/R2023b/bin/matlab -desktop Icon/usr/local/MATLAB/R2023b/toolbox/nnet/resource/nneticon.png Terminalfalse CategoriesDevelopment;Math;Science; StartupWMClassMATLABStartupWMClassMATLAB这一行很关键没有它的话桌面环境的任务栏可能无法把窗口和图标关联起来。Icon路径不一定对可以根据实际情况换一个本地png文件路径。保存后执行chmod x ~/.local/share/applications/matlab.desktop就能在应用菜单里看到MATLAB图标了。如果双击后没有反应在终端手动运行gtk-launch matlab或者查看~/.xsession-errors日志定位问题。还有一种情况是桌面环境不识别.desktop文件需要先运行update-desktop-database。5. 常见问题速查表与我的排查经验这一节把上面所有问题整理成速查表方便遇到问题时快速索引。同时分享一套我自己的排查方法论遇到实在没见过的报错时可以用。5.1 典型问题速查表问题现象可能原因解决命令/方法安装器启动后闪退缺少libxt6等图形库sudo apt install libxt6 libxrender1安装进度卡住磁盘空间不足/正常等待df -h查看空间top查看CPU判断是否存活提示Cannot read the installation filesISO损坏或权限问题sha256sum校验重新挂载加exec参数激活时无法连接服务器代理/DNS问题export http_proxy...改DNS临时测试Unable to read license file权限或路径错误检查文件属主和权限用chmod 644启动即闪退GPU驱动/OpenGL问题用matlab -softwareopengl启动中文注释乱码字体不支持中文安装fonts-noto-cjk在Preferences里改字体command not found: matlab可执行文件不在PATH中sudo ln -s /usr/local/MATLAB/R2023b/bin/matlab /usr/local/bin/matlab报错libcrypt.so.1找不到缺少libcrypt1库sudo apt install libcrypt1启动时报警告No protocol specifiedX11访问权限问题xhost SI:localuser:用户名或在纯用户下启动5.2 通用排查方法论如果上面的表里没有你的问题不要慌按下面这套流程走大概率能找到问题根源。第一个原则是看日志。MATLAB几乎会在每个关键路径生成日志文件安装日志在/tmp/mathworks_用户名目录下运行日志在~/.matlab/R2023b/logs目录下。我见过很多人遇到问题就论坛发帖问其实日志里已经写了原因。第二个原则是分步验证。不要一次做很多事情改一个变量验证一次。比如闪退问题先用-softwareopengl试如果不行再看日志而不是一上来就重装。第三个原则是善用搜索引擎。报错信息里的英文关键词直接搜索往往比自己翻译成中文搜更高效。比如MATLAB R2023b crashes on startup Ubuntu 20.04能匹配到不少英文社区的真实案例。第四个原则是确认自己的软件组合。Ubuntu 20.04 MATLAB R2023b本身是官方支持的搭配但如果你同时装了Anaconda、ROS、显卡驱动那问题就会复杂很多。排查时可以先临时屏蔽掉其他环境变量mv ~/.bashrc ~/.bashrc.bak touch ~/.bashrc matlab如果这样启动正常那就是环境变量冲突。然后再把~/.bashrc.bak里的内容逐段恢复找到是哪一段导致的问题。6. 装完之后的系统优化与使用建议这个问题其实很重要因为安装只是开始真正用得舒服才叫完成。6.1 禁用自动更新和崩溃报告MATLAB默认会检查更新在启动的时候偶尔会卡一下。如果不想被打扰可以在~/.matlab/R2023b/matlab.prf文件里找到MathWorksReportingAboutIssues false或者直接在Preferences里取消勾选Enable automatic update checks和Enable MathWorks crash reporting。6.2 配置MATLAB自启动脚本每次都要输入source ~/.bashrc或者手动设置环境变量很麻烦。可以在~/.matlab/R2023b目录下创建一个startup.m文件任何你想在MATLAB启动时自动执行的操作都可以写进去比如设置路径、定义常用变量、加载数据集等。官方默认会用这个文件但如果你自己能创建也不会有冲突。另外在~/.matlab/R2023b下创建一个matlabrc.m的系统级配置文件也是允许的它会全局影响所有用户。不过更推荐用startup.m因为更灵活而且不容易影响别人。6.3 关于在服务器上无图形界面安装如果你的目标是装在一台没有显示器的服务器上用SSH远程操作安装时可以使用命令行模式cd /mnt/matlab sudo ./install -mode silent -fileInstallationKey 你的安装密钥 -licensePath /path/to/license.lic -destinationFolder /usr/local/MATLAB/R2023b用-mode silent选项后不会启动图形界面全程命令行交互。安装完成后同样用-softwareopengl或者无图形方式启动运行。如果需要在服务器上跑MATLAB脚本可以在命令行直接使用matlab -nodisplay -nosplash运行这样比较省资源。这里补充一点经验服务器端的MATLAB对字体要求比较低不需要专门安装中文字体但如果要生成图需要额外安装libxtst6库同时建议把MATLAB_USE_USER_OPENGL设为0来促使用软件渲染。6.4 与ROS等开发环境的共存建议搜索热词里出现了一些和ROS相关的关键词这说明不少人在同一台Ubuntu机器上既装了ROS也要用MATLAB。这两个环境共存时建议注意ROS自带了一套Python环境而MATLAB R2023a之后也自带了一套Python运行时两者在同一个shell里容易出现环境变量互相干扰。所以建议启动MATLAB时先把ROS的环境变量source进来再启动MATLAB这样MATLAB可以识别到ROS而不至于冲突。不过这个话题展开讲又是一大篇了这里先提个醒具体怎么配置以后有机会专门聊。7. 写在最后的一点心得我在帮人排查MATLAB安装在Ubuntu 20.04上的问题时发现一个现象绝大多数报错都不是什么高深的技术难题而是环境准备不充分、权限配置疏忽、日志没有认真看这三类原因。很多时候问题解决不了不是能力不行而是没有一套系统的排查思路。这套流程我建议你收藏备用先检查依赖库和磁盘空间再看日志文件定位具体报错然后用分步法锁定模块问题最后才考虑重装或者求助于搜索引擎。尤其要养成看日志的习惯MATLAB的日志已经写得相当详细了不夸张地说九成问题的答案都在日志里。还有一点想说Ubuntu 20.04其实已经比较“老”了如果你的硬件比较新比如较新的Intel CPU或者NVIDIA显卡可能会遇到内核或者驱动层面的兼容问题。这时候优先确认一下系统已经完全更新sudo apt upgrade再尝试安装MATLAB。如果实在不行可以考虑升级到Ubuntu 22.04MATLAB R2023b在22.04上的体验我个人感觉更顺滑一些。不过那就是另一个话题了。