如何让VSCode按需求格式化Golang模板的Block代码

AI 小北

2026-6-19

解决VSCode中Golang模板Block格式化问题

问题分析

你遇到的问题是HTML文件中的Go模板Block被VSCode自动格式化为一行，但你期望每个Block独立成行且间隔空行。之前的设置都是针对Go代码的（[go]配置块），对HTML文件完全无效——因为VSCode会用HTML对应的格式化工具处理.html文件，而非gopls。

解决方案

1. 切换HTML文件的格式化器为Go模板专用工具

安装VSCode插件「Go Template」后，在设置中指定它作为HTML文件的默认格式化器：

"[html]": {
  "editor.defaultFormatter": "bbenoist.gotemplate",
  "editor.formatOnSave": true
}

该插件专门针对Go模板语法优化格式化，能自动保留Block的换行和空行结构。

2. 调整VSCode自带HTML格式化器规则

如果不想安装额外插件，可修改自带HTML格式化器的配置，强制保留模板Block的换行：

"[html]": {
  "editor.defaultFormatter": "vscode.html-language-features",
  "html.format.preserveNewLines": true,
  "html.format.maxPreserveNewLines": 2,
  "html.format.extraLiners": "block,end",
  "html.format.indentInnerHtml": true
}

preserveNewLines：保留手动添加的换行
maxPreserveNewLines：控制最多保留2个空行（适配你的需求）
extraLiners：指定block和end指令前后自动添加空行

3. 排除Prettier对HTML模板的干扰

如果你的VSCode安装了Prettier插件，它可能会覆盖HTML格式化规则。可通过以下方式处理：

在项目根目录创建.prettierignore文件，添加：
```
*.html
```

或在.prettierrc中针对HTML文件调整规则：

{
  "overrides": [
    {
      "files": "*.html",
      "options": {
        "htmlWhitespaceSensitivity": "ignore",
        "proseWrap": "preserve"
      }
    }
  ]
}