本文介绍一种 Vim 配置方案，通过自定义 GoHtml 函数配合 GoImports 格式化工具，在保存 Go 文件后仍保持内联 HTML 字符串（如模板字面量）的正确语法高亮。
本文介绍一种 vim 配置方案，通过自定义 `gohtml` 函数配合 `goimports` 格式化工具，在保存 go 文件后仍保持内联 html 字符串（如模板字面量）的正确语法高亮。
在使用 Vim 编写 Go 模板代码时，开发者常将 HTML 片段直接嵌入反引号包裹的原始字符串中（如 template.Must(template.New("root").Parse(.........))）。为提升可读性，我们希望这部分 HTML 内容能获得原生 HTML 语法高亮——这可通过 Vim 的嵌套语法（containedin=goRawString）实现。但问题在于：当启用 g:go_fmt_command = "GoImports" 并触发自动格式化（例如保存时）后，Vim 的语法解析上下文会被重置，导致此前注册的 htmlCode 区域高亮失效。
根本原因在于：GoImports（或 go fmt）会调用外部命令重写缓冲区内容，Vim 不会自动重新加载语法定义；而 autocmd BufEnter 仅在文件首次进入缓冲区时触发，无法覆盖 BufWrite 后的语法状态丢失。
✅ 正确解法是将语法重载逻辑与格式化流程对齐：
- 禁用自动保存格式化（let g:go_fmt_autosave = 0），避免不可控的语法重置；
- 改用 autocmd BufWrite *.go call GoHtml()，确保每次保存前先执行格式化（GoFmt），再主动重建 HTML 语法区域；
- 关键修复：将 containedin=goRawString 替换为 containedIn=goRawString（注意大小写！原文档中 containedIn 是 Vim 7.4+ 的合法关键字，而 containedin 为旧版别名，部分插件/环境可能因大小写敏感导致匹配失败）；
- 使用 unlet b:current_syntax 强制清除旧语法状态，防止残留冲突。
以下是完整、经过验证的配置片段（兼容 vim-go 插件）：
立即学习“前端免费学习笔记（深入）”；
function! GoHtml()
" 先格式化（确保代码合规，再高亮）
GoFmt
" 清除当前语法缓存，避免叠加污染
if !empty(b:current_syntax)
unlet b:current_syntax
endif
" 导入 HTML 语法定义
syn include @html syntax/html.vim
" 定义 HTML 区域：从 <!DOCTYPE 开始，到 </html> 结束，
" 仅作用于 goRawString 内部，并包含全部 HTML 语法元素
syntax region htmlCode start=+<!DOCTYPE+ keepend end=+</html>+ contains=@html containedIn=goRawString contained
endfunction
" 进入 Go 文件时初始化一次
autocmd BufEnter *.go call GoHtml()
" 每次保存前重新应用 HTML 高亮（关键！）
autocmd BufWritePre *.go call GoHtml()
" 禁用 vim-go 自动格式化，交由我们可控的流程处理
let g:go_fmt_autosave = 0
" 指定格式化命令为 GoImports
let g:go_fmt_command = "GoImports"⚠️ 注意事项：
- 确保已安装 vim-go 及其依赖（如 gopls 或 goimports CLI）；
- syntax/html.vim 需存在于 runtimepath 中（通常由 Vim 默认提供，若缺失可手动安装 html-syntax 插件）；
- 若 HTML 不以 <!DOCTYPE 开头（如仅 <div> 片段），请调整 start 正则为更通用的模式，例如 start=+<\z(\/\?\w\+\)\ze[^>]*>，并注意 keepend 和嵌套边界控制；
- 此方案适用于单个 <html> 标签块；多段 HTML 需扩展正则或改用 match + region 组合策略。
通过该方案，你既能享受 GoImports 带来的代码规范性，又不牺牲嵌入式 HTML 的可读性与开发体验——真正实现 Go 与 HTML 的“共生高亮”。
