VS Code需插件实现XML格式化,推荐Red Hat XML(首选)、XML Tools和Prettier;安装后通过快捷键Shift+Alt+Fn或右键“格式化文档”即可使用,并建议在settings.json中配置默认格式化器、保存自动格式化、属性强制换行及行宽限制。

VS Code 本身不带原生 XML 格式化能力,必须靠插件实现。装对插件 + 简单配置,就能一键美化 XML,支持自动缩进、标签对齐、属性换行等实用功能。
推荐的 XML 格式化插件
以下三款插件覆盖主流需求,按优先级推荐:
- Red Hat XML Language Support(首选):由 Red Hat 官方维护,提供语法高亮、XSD 验证、自动补全和稳定格式化,底层基于语言服务器协议(LSP),格式化逻辑严谨,适合生产环境。
- XML Tools(轻量实用):独立格式化能力强,支持“格式化文档”“压缩 XML”“转义/解码”等快捷操作,界面友好,适合快速上手或临时处理配置文件。
-
Prettier(多语言统一):如果你已在用 Prettier 管理 JS/HTML/CSS/JSON,可启用其 XML 支持(需安装
prettier-plugin-xml或确保版本 ≥ 3.0),便于团队风格统一,但 XML 细节控制不如 Red Hat 插件精细。
安装后立即可用的格式化方法
插件装好后,无需额外设置也能快速格式化:
- 打开 .xml 文件,确保右下角语言模式显示为 XML(若不是,点击右下角文字 → 选择 “XML”)
- 按下快捷键:Shift + Alt + F(Windows/Linux)或 Shift + Option + F(Mac)
- 或右键编辑器空白处 → 选择 “格式化文档”,再选对应插件(如 “Red Hat: Format Document”)
让格式化真正省心的关键配置
在 VS Code 的 settings.json 中添加以下内容(可通过 Ctrl + Shift + P → 输入 “Preferences: Open Settings (JSON)” 打开):
"[xml]": {
"editor.defaultFormatter": "redhat.vscode-xml",
"editor.formatOnSave": true
},
"xml.format.enabled": true,
"xml.format.wrapLineLength": 120,
"xml.format.splitAttributes": "force"
说明:
-
"editor.defaultFormatter"指定 XML 默认用 Red Hat 插件格式化,避免每次手动选 -
"editor.formatOnSave"开启保存即格式化,无需手动触发 -
"xml.format.splitAttributes": "force"强制每个属性独占一行,大幅提升长标签可读性 -
"xml.format.wrapLineLength": 120控制换行宽度,防止单行过长
常见问题快速解决
如果格式化没反应或效果不对,检查这几项:
- 确认已安装插件且未被禁用(扩展面板中查看状态)
- 确认文件后缀是
.xml,且右下角语言模式为 XML(不是 Plain Text) - 若用了多个 XML 插件,右键 → “格式化文档时使用” → 显式选择一个并勾选“设为默认”
- 部分老项目可能有
.vscode/settings.json覆盖了全局设置,可临时删掉或注释相关行测试










