断点不命中需先确认MATLAB引擎已共享：必须在终端手动执行matlab -nodisplay -r "matlab.engine.shareEngine('myEngine'); pause;"并保持窗口开启，同时launch.json中engineName须严格匹配；左下角显示MATLAB:Connected是调试前提，否则变量面板为空、断点失效。
断点加了但不命中？先确认 MATLAB 引擎是否已共享
VSCode 本身不运行 MATLAB，它靠的是你本机安装的 MATLAB 引擎。而调试必须走 matlab.engine.shareEngine 这条通道——不是简单打开 MATLAB 桌面端就行。常见现象是：断点灰色、F5 启动后直接跑完、调试面板里变量全空。
必须手动在终端中启动一个共享引擎进程：
-
matlab -nodisplay -r "matlab.engine.shareEngine('myEngine'); pause;"（macOS/Linux） -
"C:Program FilesMATLABR2025binmatlab.exe" -nodisplay -r "matlab.engine.shareEngine('myEngine'); pause;"（Windows）
注意：pause 不可省，否则进程立即退出；'myEngine' 是自定义名，后续 launch.json 中必须严格一致；这个终端窗口要保持打开状态。
launch.json 配置错一个字符就失败
VSCode 调试依赖 .vscode/launch.json，MATLAB 官方扩展只认一种配置模式：通过 engineName 连接已共享的引擎。填错路径、漏引号、大小写不一致都会导致“无法启动调试器”或“MATLAB not found”。
最小可用配置如下（保存在项目根目录的 .vscode/launch.json 中）：
{
"version": "0.2.0",
"configurations": [
{
"name": "MATLAB: Attach to Shared Engine",
"type": "matlab",
"request": "attach",
"engineName": "myEngine"
}
]
}
关键点：
-
"type": "matlab"必须小写，不能写成MATLAB或Matlab -
"engineName"值必须和上一步shareEngine('myEngine')中的字符串完全一致（包括单引号、大小写） - 不要加
program、args、cwd等无关字段——这不是运行脚本，是 attach 到已有引擎
断点只能加在可执行行，且文件必须已保存
MATLAB 调试器对断点位置很敏感。加在注释行、空行、函数声明行（function out = myfun(x)）上，VSCode 会显示为灰色圆圈，表示未激活。
有效断点位置包括：
- 普通语句行，如
a = rand(3); - 循环体内的第一行，如
for i = 1:10下一行 - 条件分支内，如
if x > 0后的首个表达式
另外：断点仅在文件已保存（磁盘上有 .m 文件）时生效。临时打开的未保存文件、粘贴进 REPL 的代码块，不支持断点调试。
变量看不了、改不了？检查左下角状态栏是否显示 MATLAB:Connected
即使 launch.json 和引擎都对，如果 VSCode 没连上 MATLAB 后端，调试时变量面板就是空的，右键重命名/修改值也灰掉。
务必确认：
- 左下角状态栏出现
MATLAB:Connected（首次可能延迟 2–3 秒） - 没出现？说明
matlab.defaultInterpreterPath设置错误——它必须指向matlab可执行文件本身，不是安装目录，也不是matlabroot返回值 - Windows 上路径含空格时，用双反斜杠
\或正斜杠/，别用单反斜杠
这个连接状态是调试功能的底层开关，比 launch.json 还优先。连不上，后面所有操作都是徒劳。
