VSCode无法识别MATLAB的.prj文件，应直接打开项目根文件夹；需正确配置matlab.defaultInterpreterPath路径，运行脚本推荐使用终端matlab -batch命令，多项目应通过独立.vscode/settings.json隔离配置。
VSCode 本身不识别 .prj 文件，也不加载 MATLAB 项目系统（Project Management System）的依赖图、任务或构建逻辑。你只能把 MATLAB 项目当作普通文件夹打开——但只要配置得当，编辑、运行、调试体验完全不输原生环境。
直接打开项目文件夹，别碰 .prj 文件
MATLAB 的 .prj 是专为 MATLAB 桌面设计的元数据容器，VSCode 读不懂它。试图双击 myproject.prj 打开，只会看到一个 JSON 文本，毫无作用。
- 正确做法：在 VSCode 中点击“文件 → 打开文件夹”，选择包含
.m文件和src/、tests/等子目录的**项目根文件夹**（即.prj所在同级目录） - 不要把
.prj当入口；它只是 MATLAB 桌面用来记住路径、引用、Startup Script 的快照，VSCode 不需要它也能跳转函数、查引用、格式化代码 - 如果你的项目用了
+package或@class目录结构，确保这些文件夹在打开的根目录下，否则matlab-language-server无法解析作用域
必须填对 matlab.defaultInterpreterPath
所有功能——补全、跳转、lint、运行——都依赖这个路径。填错就等于没配，状态栏不会显示 MATLAB:Connected，且报错通常是模糊的 Language server not ready 或 Cannot find MATLAB。
- Windows：用命令行运行
where matlab，取第一行结果（如C:\Program Files\MATLAB\R2023b\bin\matlab.exe），注意必须带.exe - macOS：终端执行
matlab -batch "disp(matlabroot)"得到根路径，再拼上/bin/matlab（如/Applications/MATLAB_R2023b.app/bin/matlab） - Linux：类似 macOS，路径通常为
/usr/local/MATLAB/R2023b/bin/matlab - 在 VSCode 设置中搜索
matlab.defaultInterpreterPath，点击“在 settings.json 中编辑”，写成："matlab.defaultInterpreterPath": "/Applications/MATLAB_R2023b.app/bin/matlab"
运行脚本别点右上角三角，用终端 + matlab -batch
VSCode 界面右上角的“运行”按钮（▶）行为不稳定：它默认在工作区根目录执行，但 MATLAB 脚本常依赖相对路径加载数据或调用同级函数，容易报 Undefined function or variable。
- 可靠做法：打开集成终端（
Ctrl+`），cd到脚本所在目录，再执行：matlab -batch "run('myscript.m'); exit;" - 想一键运行？在项目根目录建
.vscode/tasks.json，定义一个 task，命令字段填上面那条matlab -batch命令，并设"group": "build"，之后Ctrl+Shift+P → Tasks: Run Task就能选 - 避免用 Code Runner 插件跑 MATLAB：它默认用
matlab -r，不支持run()的路径解析逻辑，容易找不到函数
多项目共存时，用独立 .vscode/settings.json 隔离配置
如果你同时打开前端、后端、MATLAB 分析模块等多个项目（比如用多根工作区），不同 MATLAB 项目可能用不同版本（R2021b vs R2024a），或需要不同 startup.m 路径。全局设置会冲突。
- 在每个 MATLAB 项目根目录下新建
.vscode/settings.json，只写该项目专用项，例如："matlab.defaultInterpreterPath": "/opt/matlab/R2021b/bin/matlab" - 不要在用户级或工作区级 settings 中覆盖该值；VSCode 会自动优先读取项目级配置
- 如果项目含自定义工具箱（如
+/mytools），可在该settings.json中加："matlab.additionalPaths": ["./+mytools"]，让语言服务器索引进去
最容易被忽略的是：MATLAB 插件只管编辑和执行，所有图形窗口（plot、figure）、Simulink 模型、App Designer 设计器，仍必须由 MATLAB 桌面承载。VSCode 里点运行，弹出的图是 MATLAB 桌面画的——所以确保桌面程序已安装且能被 CLI 启动，否则 -batch 模式下绘图会静默失败。
