MATLAB调试不支持launch.json的args字段，必须用env传参或preLaunchTask生成变量文件；program须指向无参脚本，type为"matlab"、request为"launch"，且需确保共享引擎正常。
不能直接用 launch.json 调试带参数的 MATLAB 脚本——MATLAB 官方插件不支持 args 字段传参，也不支持 program 指向带参数的 .m 文件。 你看到的断点不命中、调试器卡在启动页、或者报 Invalid argument，基本都源于试图强行复用 Python/Node.js 的配置逻辑。
为什么 MATLAB 的 launch.json 不能填 args
MATLAB 插件（mathworks.matlab）的调试能力基于共享引擎（Shared Engine API），它只接受“无参启动 + 运行时注入变量”的方式。所有你在 args 里写的字符串，比如 ["--input", "data.mat"]，会被当成 MATLAB 命令行参数丢给 matlab 可执行文件，而 MATLAB 启动器根本不认这些格式——它只会报错或静默忽略。
-
args字段在 MATLAB 调试配置中完全无效，填了也白填 -
program必须指向一个**不含参数的脚本文件路径**，例如"${file}"或"${workspaceFolder}/main.m" - 真正传参要靠
env+ 脚本内getenv，或靠preLaunchTask注入变量到工作区
正确传参的两种实操路径
想让 main.m 接收到 input_file='config.yaml' 这类参数，只能绕过命令行 args，改用环境变量或预加载机制：
-
方式一：用
env传字符串参数 在launch.json的配置里加："env": { "MATLAB_INPUT_FILE": "config.yaml", "MATLAB_MODE": "debug" }
然后在main.m开头写：input_file = getenv('MATLAB_INPUT_FILE');
注意：环境变量值不能含空格或特殊字符，否则需额外转义 -
方式二：用
preLaunchTask动态生成变量文件 先在.vscode/tasks.json中定义一个任务，把参数写进params.mat："command": "matlab", "args": ["-batch", "save('params.mat','input_file','-struct','config'); exit;"]
再在launch.json中引用："preLaunchTask": "save-params"
脚本里用load('params.mat')读取
launch.json 配置必须满足的硬性条件
哪怕只是想让调试器连上并停在第一行，以下三点缺一不可：
-
"type"必须是"matlab"（不是"python"或留空） -
"request"只能是"launch"；"attach"对 MATLAB 无效 -
"program"路径必须存在且可读，推荐统一用"${file}"（当前打开的 .m 文件），避免相对路径解析失败 - 整个配置必须由 VSCode 齿轮图标生成——手动创建容易漏掉
"console": "integratedTerminal"，导致调试窗口黑屏无响应
最常被忽略的一点：MATLAB 调试依赖共享引擎处于活动状态。如果你改过 engineName，或用过 matlab -nojvm 启动过其他实例，当前调试会话大概率卡住不动。遇到这种情况，别调配置，先在终端执行 matlab -batch "exit" 清掉残留引擎进程。
