VSCode需通过系统PATH调用MATLAB命令并精准配置matlab.defaultInterpreterPath，否则补全、运行、调试均静默失效；必须用-batch模式运行脚本，调试前须在MATLAB中手动shareEngine。
VSCode 本身不执行 MATLAB 代码，它只是把命令发给本地安装的 MATLAB 进程去跑；只要 matlab.defaultInterpreterPath 填错、插件冲突或路径没进 PATH，所有功能（补全、运行、调试）都会静默失效——不是报错，是直接不响应。
确认 matlab 命令能被终端识别
这是所有后续操作的前提。VSCode 的插件、tasks、Code Runner 都依赖系统能直接调用 matlab 命令。
- 打开终端（Windows PowerShell / macOS Terminal / Linux bash），输入
matlab -version - 如果返回类似
R2025b，说明已就绪；若提示command not found或'matlab' is not recognized，必须先配置PATH - Windows：把
C:\Program Files\MATLAB\R2025b\bin（注意不是win64子目录）加进系统环境变量PATH - macOS：在
~/.zshrc中添加export PATH="/Applications/MATLAB_R2025b.app/bin:$PATH"，然后执行source ~/.zshrc - Linux：确保
/usr/local/MATLAB/R2025b/bin在$PATH中；部分发行版需运行sudo /usr/local/MATLAB/R2025b/bin/matlab -setup
只装官方插件并精准配置 matlab.defaultInterpreterPath
第三方插件（如 MATLAB Unofficial、matlab-formatter）会与官方插件冲突，导致语言服务崩溃、补全消失、状态栏不显示连接。
- 卸载所有非
mathworks.matlab发布者的 MATLAB 插件 - 在 VS Code 设置中搜索
matlab.defaultInterpreterPath→ 点击“在 settings.json 中编辑” - Windows 示例：
"matlab.defaultInterpreterPath": "C:/Program Files/MATLAB/R2025b/bin/matlab.exe"（正斜杠更安全） - macOS/Linux 示例：
"matlab.defaultInterpreterPath": "/Applications/MATLAB_R2025b.app/bin/matlab"（结尾不能带.exe） - 填错路径不会警告，只会让左下角始终不出现
MATLAB:Connected，且补全、运行、调试全部静默失效
用 -batch 模式运行脚本，别点右上角 ▶️ 图标
那个三角形“运行”按钮底层逻辑模糊，容易因工作区路径未同步、文件未保存或终端上下文丢失而失败，典型报错是 Undefined function or variable 或 Cannot find file。
- 最稳方式：在集成终端（
Ctrl+`）中手动执行：matlab -batch "cd('$fileDirname'); run('$fileBasenameNoExtension'); exit;" - 想一键执行？建
.vscode/tasks.json："command": "matlab"，"args": ["-batch", "cd('$fileDirname'); run('$fileBasenameNoExtension');"] - Code Runner 配置（推荐）：
"matlab": "cd $dir && matlab -batch \"run('$fileName')\""（注意双引号嵌套和转义） -
-batch是 R2022a+ 官方推荐模式，自动处理错误捕获、路径解析和静默退出；旧参数如-nosplash -nodesktop -r容易把文件名当函数调用而报错
调试需额外启动共享引擎并匹配 engineName
VS Code 官方插件的调试功能不走常规 CLI 启动，而是依赖 MATLAB 后台持久化引擎，且对 Python 版本、MATLAB 版本、engine 安装路径三者严格绑定。
- 先在 MATLAB 命令行中运行
pyversion查看支持的 Python 版本（例如 R2025b 要求 Python 3.11） - 用对应 MATLAB 自带的
setup.py安装引擎（路径类似$matlabroot/extern/engines/python），不能用 pip 装错版本 - 在
.vscode/launch.json中，"engineName"必须严格等于你在 MATLAB 中用matlab.engine.shareEngine('xxx')启动时指定的名字 - 调试前务必在 MATLAB 中先执行
matlab.engine.shareEngine()或matlab.engine.shareEngine('mydebug')，否则 VS Code 找不到引擎
最常被忽略的是：matlab.defaultInterpreterPath 填的是可执行文件路径，不是安装目录；-batch 模式默认工作目录是 MATLAB 根目录，不是脚本所在目录；调试引擎必须手动在 MATLAB 中先 shareEngine，VS Code 不会自动帮你启一个。
