golang 模板语法使不解析html标签及特殊字符

场景

有时候需要使用go的模板语法，比如说用go 去渲染html页面的时候，再比如说用go的模板搞代码生成的时候。这时候可能会遇到一个麻烦，不想转译的特殊字符被转译了。

我遇到的情况是写代码生成器的时候，‘<’ 符号被转译了，导致channel 相关的部分有问题。

这个问题很简单，但是资料不多，我也是试了半天才发现。其实把包含特殊字符的字符串 先转成 template.HTML 类型再加载到文件里 就可以了。

解决

先看代码

    t := template.New("initMysql")
    
    type NsqConsumerTpl struct {
        Names        []string
        AngleBracket template.HTML
    }
    
    v := NsqConsumerTpl{
        Names: nsqConsumerIns, 
        AngleBracket:template.HTML("<")
        
    }
        

这里首先声明了一个模板，然后声明一个结构体，用于在模板里的渲染。 其AngleBracket 字段即为一个 在模板里 不被转译的特殊字符字段。这里我用来放‘<’了.

下面的这段代码，声明一段模板，然后模板内直接引用 这个字段即可，此时 ‘<’ 不会被转译。

    tpl ：= `func (p *NsqConsumerMgr) Start() error {
        {{range .Names}}
        err := p.{{.}}.ConnectToNSQLookupds(p.{{.}}.LookupAddr)
        if err != nil {
            panic(err)
        }
        {{end}}
    
        ch := make(chan bool)
        {{ .AngleBracket }}-ch
        return nil
    }`

    t.Execute(tpl, v)

如果不知一个地方使用的话，可以提出来一个函数

定义函数，函数内容很简单，把str转成temp.HTML类型。

func unescaped (str string) template.HTML { return template.HTML(str) }

把函数注册到模板：

    t = t.Funcs(template.FuncMap{"unescaped": unescaped})

这时候，用于渲染的结构体，特殊字符也可以直接用string

    type NsqConsumerTpl struct {
        Names        []string
        AngleBracket string
    }

模板内使用稍有不同，{{ .AngleBracket | unescaped}} 这一句的意思是： 通过 通道（类似linux 通道的概念）把AngleBracket 作为参数，传给unescaped 函数。

func (p *NsqConsumerMgr) Start() error {
    {{range .Names}}
    err := p.{{.}}.ConnectToNSQLookupds(p.{{.}}.LookupAddr)
    if err != nil {
        panic(err)
    }
    {{end}}

    ch := make(chan bool)
    {{ .AngleBracket | unescaped}}-ch
    return nil
}
    t.Execute(tpl, v)

查起来比较费劲，于是总结与此，分享一下。
欢迎补充

有收获记得点赞哦～