必须安装MathWorks官方插件、正确配置matlab.defaultInterpreterPath为MATLAB可执行文件绝对路径、手动启动共享引擎并匹配engineName，三者缺一不可，否则调试失败。
能调试，但必须满足三个硬性前提：装对插件、路径配准、共享引擎手动启动。缺一不可，否则点 F5 只会看到“MATLAB not found”或断点完全不命中。
确认只装了 MathWorks 官方 MATLAB 插件
第三方插件（如 MATLAB Unofficial、matlab-formatter）会和官方插件抢语言服务器注册权，导致补全失效、mlint 报错、状态栏不显示 MATLAB:Connected。
- 打开 VS Code 扩展面板（
Ctrl+Shift+X），搜索matlab - 卸载所有发布者不是
mathworks.matlab的扩展 - 仅保留并重装官方插件，安装后重启 VS Code
- 成功连接后，左下角状态栏应稳定出现
MATLAB:Connected（首次可能延迟 2–3 秒）
正确配置 matlab.defaultInterpreterPath
这个值不是 MATLAB 安装目录，也不是 matlabroot 返回路径，而是指向可执行文件的**绝对路径**。填错等于没配。
- Windows：在命令行运行
where matlab，取第一行结果（如C:\Program Files\MATLAB\R2023b\bin\matlab.exe） - macOS/Linux：终端执行
matlab -batch "disp(matlabroot)"，再拼上/bin/matlab（如/Applications/MATLAB_R2023b.app/bin/matlab） - VS Code 设置中搜索
matlab.defaultInterpreterPath→ 点击“在 settings.json 中编辑”，填入上述路径 - 保存后检查状态栏是否变为
MATLAB:Connected；若仍是灰色，说明路径错误或 MATLAB 未加入系统 PATH
调试前必须手动启动共享引擎
VS Code 的 MATLAB 调试器不直接拉起 GUI 版 MATLAB，而是通过 TCP 连接一个已启动的、共享了引擎的无界面进程。这步不能跳过，也不能靠 launch.json 自动完成。
- 在系统终端（非 VS Code 集成终端）中执行：
matlab -nodisplay -r "matlab.engine.shareEngine('myEngine'); pause;" - 确保该命令执行后 MATLAB 进程持续运行（窗口不会退出，光标停在命令行等待）
- 在 VS Code 工作区的
.vscode/launch.json中，配置engineName严格匹配上面的字符串："engineName": "myEngine" - 断点只能设在脚本文件（
.m）里，函数文件（function定义块）需确保被调用路径可达，否则调试器无法加载符号
常见断点不命中的真实原因
不是插件问题，也不是 VS Code 本身 bug，而是通信链路卡在某个环节。最常被忽略的是工作目录和变量作用域。
- 脚本运行时当前工作目录不是
${fileDirname}？检查launch.json中workingDirectory是否设为"${fileDirname}" - 你在函数内部设断点，但该函数是通过
eval或字符串命令调用的？调试器无法追踪动态调用路径 - 调试过程中执行了
clear all？这会清空调试器已加载的变量上下文，导致 Variables 面板变空、断点失效 - 你改了代码但没保存？VS Code 调试器读的是磁盘文件，不是编辑器缓存内容
真正卡住人的地方，往往不是“怎么配”，而是“为什么配了还不行”——尤其是共享引擎那条命令必须在独立终端里保持运行，且 engineName 大小写、引号、拼写必须和 launch.json 里完全一致。少一个字符，整个调试链就断了。
