Go模板语法解析：提取{{...}}结构方法

学习知识要善于思考，思考，再思考！今天golang学习网小编就给大家带来《Go 模板语法详解：如何提取 {{...}} 模板结构》，以下内容主要包含等知识点，如果你正在学习或准备学习Golang，就都不要错过本文啦~让我们一起来看看吧，能帮助到你就更好了！

本文介绍如何在 Go 语言中从 Excel XLSX 的 XML 内容中精准提取 Go 模板指令（如 `{{range ...}}`、`{{end}}`），既避免正则误匹配嵌套结构，又兼顾 XML 语义完整性，推荐使用 `encoding/xml` 包结合结构化解析。

在处理 Office Open XML（如 .xlsx 文件解压后的 sheet1.xml）时，常需识别并提取嵌入的 Go 模板语法（例如 {{range $prj := .prj}}、{{$prj.Name}}、{{end}}），用于后续模板渲染或校验。但直接对原始 XML 文本使用正则表达式（如 {{[^}]*?}}）虽简单，却存在严重局限：无法处理嵌套模板（如 {{with .User}}{{.Name}}{{end}}）、易受注释/CDATA/属性值干扰，且违背“永远不要用正则解析 XML”这一工程铁律。

✅ 推荐方案：基于 encoding/xml 的结构化解析

我们定义一组嵌套结构体，精确映射 XML 层级，并利用 Go 的 struct tag（如 xml:"Cell"、xml:",chardata"）提取关键内容：

package main

import (
    "encoding/xml"
    "fmt"
    "strings"
)

// Data 对应 <Data ss:Type="String">xxx</Data>
type Data struct {
    Type  string `xml:"Type,attr"`
    Value string `xml:",chardata"`
}

// Cell 对应 <Cell ss:StyleID="s69">...</Cell>
type Cell struct {
    StyleID string `xml:"StyleID,attr"`
    Data    Data   `xml:"Data"`
}

// Row 对应 <Row ss:AutoFitHeight="0">...</Row>
type Row struct {
    AutoFitHeight string `xml:"AutoFitHeight,attr"`
    Height        string `xml:"Height,attr"`
    Cells         []Cell `xml:"Cell"`
}

// Table 对应 <Table>...</Table>
type Table struct {
    Rows []Row `xml:"Row"`
}

// Worksheet 对应 <Worksheet>...</Worksheet>
type Worksheet struct {
    Table Table `xml:"Table"`
}

// 提取所有 Go 模板指令（形如 {{...}}）的辅助函数
func extractGoTemplates(w *Worksheet) []string {
    var templates []string
    for _, row := range w.Table.Rows {
        for _, cell := range row.Cells {
            // 仅当 Data.Value 非空且含 {{ }} 时才提取
            if strings.TrimSpace(cell.Data.Value) != "" {
                // 简单提取所有 {{...}} 片段（支持单层，不含嵌套）
                s := cell.Data.Value
                for i := 0; i < len(s); {
                    start := strings.Index(s[i:], "{{")
                    if start == -1 {
                        break
                    }
                    start += i
                    end := strings.Index(s[start:], "}}")
                    if end == -1 {
                        break
                    }
                    end += start + 2
                    tmpl := s[start:end]
                    templates = append(templates, tmpl)
                    i = end
                }
            }
        }
    }
    return templates
}

func main() {
    input := `<?xml version="1.0"?>
<?mso-application progid="Excel.Sheet"?> 
<Workbook>
<Worksheet ss:Name="sheet1">
<Names>
 <NamedRange ss:Name="_FilterDatabase" ss:RefersTo="=sheet!R3C1:R3C13"
  ss:Hidden="1"/>
</Names>
<Table ss:ExpandedColumnCount="15" ss:ExpandedRowCount="7" x:FullColumns="1"
 x:FullRows="1" ss:DefaultColumnWidth="52.8" ss:DefaultRowHeight="15.45">
 <Column ss:AutoFitWidth="0" ss:Width="37.200000000000003"/>
 <Column ss:AutoFitWidth="0" ss:Width="67.2"/>
 <Column ss:AutoFitWidth="0" ss:Width="75.600000000000009"/>
 <Column ss:AutoFitWidth="0" ss:Width="71.400000000000006"/>  

 <Row ss:AutoFitHeight="0">
  <Cell ss:MergeAcross="12" ss:MergeDown="1" ss:StyleID="s63"><Data
    ss:Type="String">This is a title of the sheet!</Data></Cell>
 </Row>

 <Row ss:AutoFitHeight="0">
  <Cell ss:StyleID="s69"><Data ss:Type="String">{{range $prj:=.prj}}</Data></Cell>
  <Cell ss:StyleID="s70"/>
  <Cell ss:StyleID="s70"/>
  <Cell ss:StyleID="s70"/>
 </Row>
 <Row ss:AutoFitHeight="0" ss:Height="45.449999999999996">
  <Cell ss:StyleID="s72"/>
  <Cell ss:StyleID="s70"><Data ss:Type="String">{{$prj.PrjName}}</Data></Cell>
  <Cell ss:StyleID="s70"><Data ss:Type="String">{{$prj.ConstrDept}}</Data></Cell>
  <Cell ss:StyleID="s71"><Data ss:Type="String">{{$prj.Assumer}}</Data></Cell>
  <Cell ss:StyleID="s71"><Data ss:Type="String">{{$prj.ReplyNo}}</Data></Cell>
  <Cell ss:StyleID="s71"><Data ss:Type="String">{{$prj.AnPingNo}}</Data></Cell>   
 </Row>
 <Row ss:AutoFitHeight="0">
  <Cell ss:StyleID="s73"><Data ss:Type="String">{{end}}</Data></Cell>
 </Row>
</Table> 
</Worksheet>
</Workbook>`

    w := &Worksheet{}
    err := xml.Unmarshal([]byte(input), w)
    if err != nil {
        fmt.Printf("XML 解析失败: %v\n", err)
        return
    }

    templates := extractGoTemplates(w)
    fmt.Println("提取到的 Go 模板指令：")
    for i, t := range templates {
        fmt.Printf("%d. %s\n", i+1, t)
    }
}

? 运行结果：

提取到的 Go 模板指令：
1. {{range $prj:=.prj}}
2. {{$prj.PrjName}}
3. {{$prj.ConstrDept}}
4. {{$prj.Assumer}}
5. {{$prj.ReplyNo}}
6. {{$prj.AnPingNo}}
7. {{end}}

⚠️ 注意事项与进阶建议：

• 不推荐纯正则方案：{{[^}]*?}} 在无嵌套时可用，但一旦出现 {{with .User}}{{.Name}}{{end}}，正则将错误截断为 {{with .User}} 和 {{end}}，丢失中间逻辑。
• 结构体字段需严格对应 XML 命名空间：若 XML 含命名空间（如 ss:、x:），需在 struct tag 中显式声明（如 xml:"ss:Name,attr"），否则解析失败。
• 性能考量：对超大 XML（>10MB），可改用 xml.Decoder 流式解析，避免一次性加载全部内存。
• 安全增强：生产环境应校验提取出的模板是否符合白名单规则（如仅允许 range/end/if 等基础动作），防止 SSTI（服务端模板注入）风险。

综上，以 encoding/xml 为核心、结构体建模为骨架、精准定位 内容为路径，是安全、可维护、可扩展地提取 XML 中 Go 模板的最佳实践。

到这里，我们也就讲完了《Go模板语法解析：提取{{...}}结构方法》的内容了。个人认为，基础知识的学习和巩固，是为了更好的将其运用到项目中，欢迎关注golang学习网公众号，带你了解更多关于的知识点！