根本原因是vscode终端路径、matlab扩展配置与matlab命令执行环境三者未对齐;必须同步配置terminal.integrated.cwd、matlab.defaultinterpreterpath指向可执行文件,并根据运行方式(图标/终端/选中代码)匹配对应路径逻辑。

VSCode 运行 MATLAB 时工作路径不匹配,根本原因不是 MATLAB 自身没设好,而是 VSCode 的终端默认路径、MATLAB 扩展配置、以及 matlab 命令实际执行环境三者没对齐。只改其中一项,大概率失效。
terminal.integrated.cwd 决定终端初始位置
VSCode 集成终端的起始目录由 terminal.integrated.cwd 控制,它直接影响你在终端里敲 matlab -batch "run('script.m')" 时 MATLAB 的当前工作目录。
-
${workspaceFolder}:最稳妥,适合单项目工作区;终端一打开就在根目录,run('a.m')能直接找到同级脚本 -
${fileDirname}:适合多文件散落场景;但没打开任何文件时会 fallback 到用户主目录,行为不稳定 -
${userHome}或${env:HOME}:仅用于调试或统一环境,一般不推荐 - 绝对路径如
"D:\my-matlab-proj":硬编码,跨机器失效,慎用
修改方式:Ctrl + , → 搜索 terminal.integrated.cwd → 编辑值;或在 settings.json 中加一行:"terminal.integrated.cwd": "${workspaceFolder}"。
matlab.defaultInterpreterPath 必须指向可执行文件,不是安装目录
VSCode MATLAB 扩展启动引擎时,会调用这个路径下的二进制文件。如果它指向的是安装根目录(比如 C:Program FilesMATLABR2023b),就会报 MATLAB not found——因为根本没执行权限。
- Windows:用
where matlab查真实路径,通常是C:Program FilesMATLABR2023binwin64matlab.exe(注意双反斜杠或正斜杠都行) - macOS/Linux:用
which matlab或matlab -batch "disp(matlabroot)"确认根目录后,拼上/bin/matlab - 填错会导致状态栏不显示
MATLAB:Connected,所有运行/补全/调试功能全部瘫痪
务必在设置中搜 matlab.defaultInterpreterPath,点“在 settings.json 中编辑”,粘贴完整路径,不要漏 .exe 或引号。
运行 .m 文件时路径仍错?检查你用的是哪种方式
VSCode 有三种常见 MATLAB 运行方式,每种对路径的依赖逻辑完全不同:
- 点击右上角 ▶ 图标:走扩展内置逻辑,**完全依赖
matlab.defaultInterpreterPath和当前文件是否已保存**;未保存文件会失败,且不切换工作目录到${fileDirname} - 终端手动执行
matlab -nodisplay -r "run('script.m'); exit;":工作目录 = 终端当前目录 =terminal.integrated.cwd的取值,与文件位置无关 - 选中代码 + Ctrl+Enter:走 MATLAB Engine eval,**不切换路径、不读取文件系统、不依赖保存状态**,只执行高亮内容,适合调试片段
如果你总遇到 Undefined function or variable 或 Cannot find script.m,先确认你用的是哪一种方式,再回溯对应路径控制点。
别忽略 MATLAB 自身的初始路径设置
即使 VSCode 终端和扩展都配对了,MATLAB 启动后仍可能自动 cd 到它自己的默认路径(比如 bin 目录)。这是 MATLAB 客户端行为,独立于 VSCode。
- 快捷方式属性里的“起始位置”字段(Windows)或 AppleScript 传参(macOS)能覆盖它
- 更可靠的是改
matlabrc.m:在[matlabroot]/toolbox/local/matlabrc.m末尾加cd('/your/project/path'); - VSCode 里用
matlab -batch "cd('/path'); run('script.m'); exit;"也能临时绕过
真正容易被忽略的是:VSCode 不控制 MATLAB 的内部工作路径,只控制“在哪启动它”;而 MATLAB 启动后立刻执行自己的一套初始化逻辑。两者必须显式对齐,不能指望一方自动适配另一方。











