MATLAB官方插件在多根工作区中仅激活当前根目录的语言服务器，不自动扫描其他根目录路径，导致跳转失败、补全缺失和运行报错；需通过matlab.additionalPaths手动添加绝对路径、统一settings配置、分根设置tasks.json与launch.json，并注意cwd与路径大小写、空格等陷阱。
多根工作区本身不直接支持 MATLAB 语言服务跨根目录联动，matlab 插件（MathWorks 官方）只会在**当前活动的根文件夹**中启动语言服务器，并且仅识别该根下的 .m 文件和路径。想在多根工作区里“协同开发”MATLAB 项目，关键不是让插件自动跨根扫描，而是手动理清路径依赖、统一执行上下文、避免符号解析断裂。
为什么 MATLAB 插件在多根工作区里不自动识别其他根目录
官方 matlab 插件的语言服务器（matlab-language-server）启动时，只读取当前激活的根文件夹（即你右键点击或通过 Ctrl+K Ctrl+R 切换到的那个）下的 pathdef.m 或用户设置的 MATLAB 路径。它不会遍历 .code-workspace 中定义的其他 folders，也不会自动把它们加进 MATLAB 的搜索路径（addpath）里。
常见错误现象：
- 你在
./simulink-models根下打开一个controller.m，能跳转、补全正常；但切换到./matlab-lib根后，再打开同一文件，提示 “No definition found” -
Go to Definition跳转失败，或跳到空文件，因为目标函数实际在另一个根目录里 - 终端运行
run('test.m')报错Undefined function or variable，尽管该函数就在隔壁根目录的+/utils/下
怎么让多个 MATLAB 相关根目录真正“协同”起来
核心思路：把其他根目录当作“外部工具箱”显式加入 MATLAB 运行时路径，同时用 VSCode 设置确保编辑器行为一致。
实操建议：
- 在工作区级
.code-workspace的settings中统一配置 MATLAB 相关项，例如：{ "settings": { "matlab.defaultInterpreterPath": "/Applications/MATLAB_R2024b.app/bin/matlab", "matlab.executionMode": "terminal", "files.associations": { "*.m": "matlab" } } } - 在主开发根目录（比如
./main-app）的.vscode/settings.json中，用matlab.additionalPaths手动添加其他根目录的绝对路径："matlab.additionalPaths": [ "/full/path/to/matlab-lib", "/full/path/to/simulink-models" ]
（注意：必须是绝对路径，相对路径无效） - 所有 MATLAB 根目录都应包含自己的
startup.m（可选），并在其中调用addpath加载其他模块——但这只影响 MATLAB 运行时，不影响 VSCode 的静态分析 - 避免在非主根目录中启用
matlab.languageServerEnabled，否则会起多个冲突的语言服务器实例
调试与任务配置必须绑定到具体根目录
VSCode 的 launch.json 和 tasks.json 是按根目录生效的，不能跨根复用。如果你希望从任意根目录都能一键运行主脚本，得做两件事：
- 在每个根目录的
.vscode/tasks.json中定义相同名称的任务（如run-main），但各自指定不同的args和cwd； - 调试配置
launch.json中的program字段必须写成相对于该根目录的路径，例如："program": "${workspaceFolder}/main.m"，而不是跨根引用"${workspaceFolderB}/main.m"（VSCode 不支持） - 如果要用
matlab.debugger启动调试，确保matlab.defaultInterpreterPath指向支持调试的 MATLAB 版本（R2022a 及以上），且终端有足够权限加载 Java 依赖
容易被忽略的路径陷阱
最常出问题的是 MATLAB 当前工作目录（pwd）和 VSCode 工作区根目录不一致。当你在 ./matlab-lib 根中打开一个 .m 文件并点击运行，插件默认以该根为 cwd 启动 MATLAB，但你的主入口脚本可能依赖 ./main-app/data/ 下的数据——这时要么改代码用绝对路径，要么在 tasks.json 中强制指定 "cwd": "${workspaceFolder}/../main-app"。
另外，matlab.additionalPaths 添加的路径若含空格或中文，必须用双引号包裹，且 Windows 下反斜杠要转义为 \ 或统一用正斜杠 /；macOS/Linux 下注意大小写敏感，而 MATLAB 默认不区分，但文件系统区分。
