matlab-formatter插件已停止维护，应卸载；仅用MathWorks官方插件（mathworks.matlab）的matlab.formatOnSave功能格式化MATLAB代码，需正确配置matlab.defaultInterpreterPath并确保状态栏显示MATLAB:Connected。
matlab-formatter 插件已停止维护，别再用它
现在 VS Code 里真正能稳定格式化 MATLAB 代码的，只有 MathWorks 官方插件自带的 matlab.formatOnSave 和 matlab.formatOnType 功能。第三方 matlab-formatter 插件早在 2023 年就停止更新，与 R2024a+ 版本的 MATLAB 引擎不兼容，启用后常导致格式化卡死、缩进错乱或直接报 Failed to format document。
官方插件（mathworks.matlab）从 R2023b 起内置了基于 MATLAB Language Server 的格式化能力，无需额外安装 formatter，也不依赖 Python 或外部工具。
- 卸载所有带
matlab-formatter字样的扩展，包括旧版 “MATLAB Formatter” 或 “MATLAB Code Style” - 确认只保留
mathworks.matlab官方插件，并已成功连接（状态栏显示MATLAB:Connected） - 格式化行为由 MATLAB 引擎本地执行，所以必须确保
matlab.defaultInterpreterPath配置正确且可调用
如何开启保存时自动格式化（matlab.formatOnSave）
这是最常用也最稳妥的格式化方式，触发时机明确、不干扰编辑节奏，且完全走 MATLAB 原生解析器，语义准确。
在 VS Code 的 settings.json 中添加：
"matlab.formatOnSave": true, "matlab.formatOnType": false
注意：formatOnType 默认关闭，因为实时格式化在函数定义、多行 if/for 块中容易误触发，造成光标跳转或缩进抖动。
- 格式化仅作用于当前打开的
.m文件，不递归处理项目内其他文件 - 若保存后无反应，先检查状态栏是否为
MATLAB:Connected；未连接则格式化功能完全不可用 - 首次保存触发格式化可能稍慢（约 1–2 秒），是语言服务器加载 AST 的正常开销
格式化行为由 MATLAB 引擎控制，不是 VS Code 决定的
VS Code 这边只是发请求，实际排版逻辑全在你本地 MATLAB 版本里。这意味着：
- R2022b 和 R2025b 对
classdef块的缩进策略不同，前者默认顶格，后者支持嵌套缩进 - 中文注释对齐、连续赋值对齐（
a = 1; b = 2;）等细节，取决于你所配 MATLAB 版本的mlint和内部 formatter 实现 - 不支持自定义缩进空格数（如强制 2 空格），
matlab.formatOnSave固定使用 MATLAB 桌面端“首选项 → MATLAB → 编辑器 → 缩进”里的设置 - 如果 MATLAB 桌面端里关掉了“自动缩进”，VS Code 里
formatOnSave也会变弱——它复用同一套引擎配置
遇到格式化失败：先看错误输出面板，不是重装插件
常见失败现象是保存后无变化，或弹出提示 Formatting failed. Please check the MATLAB output channel.。这时候该看的是 VS Code 底部面板的 Output → 切换到 MATLAB 标签页，而不是删插件重装。
- 典型错误：
Invalid MEX-file—— 表示你配的 MATLAB 路径指向了 32 位版本，而 VS Code 是 64 位进程（Windows 常见） -
Engine is busy—— MATLAB 引擎正在运行长任务（比如绘图、Simulink 仿真），需等其空闲或重启引擎 - 空白输出 + 无响应 —— 很可能是
matlab.defaultInterpreterPath指向了matlab.exe的快捷方式而非真实可执行文件（尤其 macOS 上用 Launchpad 启动的 .app 包）
复杂点在于：格式化失败不会阻断保存，也不会报红错，容易被忽略。但长期不生效，会导致团队协作中缩进风格混乱——这点比补全失效更隐蔽，也更难排查。
