VSCode不管理MATLAB项目，仅管理文件路径和工作区；跨文件跳转不准主因是语言服务器未正确启动或函数路径未被MATLAB识别，需准确配置matlab.defaultInterpreterPath、启用onDemand模式，并通过MATLAB.additionalPaths显式声明函数所在目录。
VSCode 本身不管理 MATLAB 项目，只管理文件路径和工作区
VSCode 没有“MATLAB 项目”这个概念，它只认 workspace（工作区）和 folder（文件夹）。你打开一个含 .m 文件的目录，VSCode 就把它当普通文件夹处理；加个 .code-workspace 文件，才形成可保存设置、任务、调试配置的真正工作区。MATLAB 自己的 project.prj 文件 VSCode 完全不识别，也不会加载变量、路径或工具箱依赖——这些仍得靠 MATLAB 桌面或命令行启动时加载。
如何让多文件 MATLAB 工程在 VSCode 中跳转准确？
跨文件函数跳转不准，根本原因不是 VSCode，而是语言服务器找不到函数定义位置。这通常由三类问题导致：
-
MATLAB.installPath或matlab.defaultInterpreterPath配错：路径指向了安装目录而非matlab.exe（Windows）或bin/matlab（macOS/Linux），语言服务器无法启动mlint或matlab-language-server - 未启用
onDemand模式：在settings.json中设"MATLAB.matlabConnectionTiming": "onDemand"，否则服务器可能在无 MATLAB 进程时静默失败 - 函数未被 MATLAB 路径收录：VSCode 不读取
startup.m或addpath，必须手动把含函数的文件夹加进 MATLAB 的path，或在settings.json中用"MATLAB.additionalPaths"显式声明（如["./src", "./lib"]）
为什么 .vscode/settings.json 里要区分用户级和工作区级配置？
用户级 settings.json（全局）适合通用设置，比如字体、缩进、Git 默认行为；但 MATLAB 相关路径、编码、additionalPaths 必须写在工作区级（即项目根目录下 .vscode/settings.json）中，否则会污染其他项目。例如：
{
"MATLAB.installPath": "/Applications/MATLAB_R2025b.app",
"MATLAB.matlabpath": "/Applications/MATLAB_R2025b.app/bin/matlab",
"MATLAB.additionalPaths": ["./src", "./utils"],
"[matlab]": {
"files.encoding": "utf8"
}
}
如果把 additionalPaths 写在用户级，你在打开纯 Python 项目时，VSCode 仍会尝试用 MATLAB 语言服务器解析 .py 文件，造成 CPU 占用飙升或补全卡死。
常见目录结构建议与实际陷阱
推荐按功能分层，但要注意 VSCode 不会自动识别层级语义，所有路径都需显式声明：
-
./src/：放主函数、类定义、核心算法（必须加入MATLAB.additionalPaths） -
./tests/：测试脚本，命名建议以test_*.m开头；VSCode 不运行测试框架，但可配合tasks.json调用matlab -batch "runtests('tests')" -
./data/：二进制或 MAT 文件，VSCode 不解析内容，但建议在.gitignore中排除大文件 -
./docs/：说明文档，避免放.m文件，否则会被语言服务器误扫，拖慢索引
特别注意：./+package/ 和 ./@class/ 这类 MATLAB 特殊目录，VSCode 不理解其作用域规则，跳转时可能找不到 +mypkg/myfunc，必须确保整个 +package 父目录已加入 additionalPaths，且路径中不含空格或中文。
