调试MATLAB类文件必须手动启动共享引擎并严格匹配engineName：先在终端执行matlab -nodisplay -r "matlab.engine.shareEngine('myOOEngine'); pause;"，再在launch.json中配置"engineName": "myOOEngine"，断点须设在classdef文件内部方法中。
调试 MATLAB 类文件必须启用 matlab.engine.shareEngine
VSCode 本身不运行 MATLAB，调试依赖本地 MATLAB 进程提供引擎服务。类文件（@MyClass 目录结构）和面向对象程序（classdef）的调试，要求 MATLAB 启动时共享一个命名引擎，否则断点根本不会命中——你点 F5，脚本直接跑完，调试面板空白，变量窗口空空如也。
关键动作不是配 VSCode，而是先在终端手动启动带共享名的 MATLAB 引擎：
- macOS/Linux：
/Applications/MATLAB_R2023b.app/bin/matlab -nodisplay -r "matlab.engine.shareEngine('myOOEngine'); pause;" - Windows：
"C:\Program Files\MATLAB\R2023b\bin\matlab.exe" -nodisplay -r "matlab.engine.shareEngine('myOOEngine'); pause;"
注意：pause 不可省略，它让进程保持活跃等待连接；myOOEngine 是自定义名称，后续要和 launch.json 严格一致；-nodisplay 必须加，GUI 模式下共享引擎会失败。
launch.json 中 engineName 必须与共享名完全匹配
VSCode 调试器靠这个字符串去连上你刚才启动的 MATLAB 引擎。一旦大小写、下划线、拼写有差异，就会报错 Could not connect to shared MATLAB engine，且不会给出具体哪错了。
在项目根目录的 .vscode/launch.json 中配置如下（仅保留这一项即可，不要混用其他 launch 类型）：
{
"version": "0.2.0",
"configurations": [
{
"name": "MATLAB: Attach to Shared Engine",
"type": "matlab",
"request": "attach",
"engineName": "myOOEngine"
}
]
}
常见错误：
- 误填
engineName为路径或 MATLAB 安装目录 - 在
settings.json里配了matlab.defaultInterpreterPath就以为够了——它只管运行，不管调试 - 没删掉默认生成的
launch.json中的run或launch配置，导致 VSCode 尝试以错误方式启动新 MATLAB 实例
类方法断点需在类定义文件中设置，不能只在调用处
MATLAB 面向对象调试有个隐性规则：断点必须落在 classdef 文件内部的方法体中（比如 function out = compute(obj, x) 的第一行），而不是在外部脚本里调用 obj.compute(x) 的那行。后者只会让 VSCode 停住，但 MATLAB 引擎实际已跳过该方法，变量面板里看不到 obj 的属性值。
验证是否生效的小技巧：
- 在
@MyClass/myMethod.m第一行加断点，运行调用脚本 - 命中后，在调试控制台输入
whos，应能看到obj和其属性 - 若
obj显示为undefined，说明断点没进到类方法作用域，大概率是引擎未共享或engineName不匹配
工作区变量查看对 classdef 支持有限，别依赖侧边栏编辑复杂字段
VSCode 新版确实加了变量侧边栏，但对类实例的支持仍停留在“显示名称、类型、尺寸”层面。你无法在侧栏里双击展开 obj.prop.field.subfield 查看嵌套结构，也不能直接修改 obj.array(1:3) 这样的索引赋值。
真正可靠的操作方式仍是：
- 在调试控制台（Debug Console）中手动输入
obj.prop查看字段 - 用
edit obj打开 MATLAB 原生变量编辑器（仅限标量、向量、矩阵等基础类型） - 对结构体数组或嵌套对象，优先用
disp(obj)或properties(obj)辅助定位
这个限制不是配置问题，是当前 MATLAB 插件语言服务器对 classdef 元数据解析能力的边界——它能识别类，但还没法把整个对象图谱实时同步给 VSCode UI。
