VSCode需通过MATLAB官方扩展的LSP服务实现.m文件格式化，须正确配置settings.json中"[matlab]": {"editor.formatOnSave": true, "editor.defaultFormatter": "mathworks.language-matlab"}，并确保MATLAB路径在PATH中、LSP启动成功且版本≥R2023a。
VSCode 本身不原生支持 MATLAB 代码的自动格式化，必须依赖官方 MATLAB 扩展 + 正确配置的 LSP 服务才能触发保存时格式化；只开 editor.formatOnSave 没用，因为默认没有注册 MATLAB 格式化器。
确认 MATLAB 扩展已启用且 LSP 正常启动
MATLAB 官方扩展（MathWorks MATLAB）是唯一提供格式化能力的 VS Code 插件。它不靠独立子进程，而是通过内置的 LSP（Language Server Protocol）服务实现格式化。常见失效原因不是插件没装，而是 LSP 启动失败：
- 打开命令面板（
Ctrl+Shift+P），运行Developer: Toggle Developer Tools，切换到 Console 标签页，保存一个.m文件，看是否有类似Failed to start MATLAB language server的报错 - 检查右下角状态栏是否显示
MATLAB（不是Plain Text或Matlab小写）；若显示错误语言模式，手动点击切换并选择MATLAB - 确保系统 PATH 中包含 MATLAB 可执行路径（如 Windows 上
C:\Program Files\MATLAB\R2024b\bin\matlab.exe），否则 LSP 无法拉起后台服务 - 首次启用后可能需等待 10–20 秒，LSP 才完成初始化；此时右键 →
Format Document会提示 “No formatter available”
必须显式设置 MATLAB 默认格式化器
VSCode 不会为 MATLAB 自动选中格式化器，即使扩展已启用。你必须在 settings.json 中明确指定语言专属的 editor.defaultFormatter：
- 编辑工作区或用户级
settings.json，添加以下块（注意方括号语法）：
"[matlab]": {
"editor.formatOnSave": true,
"editor.defaultFormatter": "mathworks.language-matlab"
}
- 不要写成全局
"editor.defaultFormatter": "..."—— 这会导致其他语言（如 Python）格式化异常 - 扩展 ID 必须是
mathworks.language-matlab（不是mathworks.matlab或其他变体），ID 错误将静默失败 - 如果项目中同时存在
.m和.mlx（Live Script），目前仅.m支持格式化；.mlx文件暂无格式化能力
格式化行为受 MATLAB 版本与配置限制
MATLAB 扩展的格式化逻辑直接调用 MATLAB 桌面端的 codeformatter 工具，因此实际效果取决于你本地安装的 MATLAB 版本及其偏好设置：
- R2023a 及之后版本才完整支持 LSP 格式化；R2022b 及更早版本仅提供基础语法高亮，无格式化入口
- 格式化规则不可自定义（不像 Prettier 或 Black 那样有
.prettierrc）；它严格遵循 MATLAB 桌面“首选项 → MATLAB → 代码格式化”里的勾选项（如空格、换行、缩进宽度） - 若你在 MATLAB 桌面中关闭了“启用代码格式化”，VS Code 中保存也不会触发任何改动
- 函数定义块、类定义块、注释对齐等格式化动作，只有在 MATLAB 后台服务响应成功时才会执行；网络隔离环境或防火墙拦截 localhost 通信会导致超时跳过
最容易被忽略的一点：MATLAB 扩展的格式化是同步阻塞式的——保存操作会卡住直到 MATLAB 后台返回结果。如果发现保存明显变慢，不是配置错了，而是 MATLAB 进程响应延迟；这时别急着关掉格式化，先检查 MATLAB 是否处于空闲状态、有没有弹窗阻塞或未响应。
