0

0

Golang模板函数自定义与渲染技巧

P粉602998670

P粉602998670

发布时间:2025-09-12 11:41:01

|

308人浏览过

|

来源于php中文网

原创

自定义golang模板函数需通过template.funcmap注册函数,如toupper;处理复杂数据可用管道访问嵌套字段,如.address.city;条件判断用{{if}} {{else}} {{end}},循环用{{range}}遍历数据;为防xss,默认自动转义html,可显式使用{{.userinput | html}};结构体方法若首字母大写,可在模板中直接调用,如{{.fullname}}。

golang模板函数自定义与渲染技巧

Golang模板函数自定义与渲染技巧:简单来说,就是教你如何扩展Go模板的功能,让它能做更多的事情,以及如何更灵活地使用这些模板。

模板函数自定义与渲染技巧

如何自定义Golang模板函数?

自定义模板函数,其实就是给

template.FuncMap
添加你自己的函数。这有点像给工具箱添加新工具。你需要先定义一个Go函数,然后把它注册到
FuncMap
里,最后在模板里就可以像使用内置函数一样使用它了。

举个例子,假设你需要一个函数来把字符串转换成大写。你可以这样:

立即学习go语言免费学习笔记(深入)”;

package main

import (
    "fmt"
    "html/template"
    "os"
    "strings"
)

// 定义一个函数,将字符串转为大写
func toUpper(s string) string {
    return strings.ToUpper(s)
}

func main() {
    // 创建一个FuncMap,并将自定义函数注册进去
    funcMap := template.FuncMap{
        "toUpper": toUpper,
    }

    // 创建一个模板,并使用FuncMap
    tmpl, err := template.New("test").Funcs(funcMap).Parse(`
        {{ .Name }} 的大写是:{{ toUpper .Name }}
    `)
    if err != nil {
        panic(err)
    }

    // 定义数据
    data := struct {
        Name string
    }{
        Name: "golang",
    }

    // 渲染模板
    err = tmpl.Execute(os.Stdout, data)
    if err != nil {
        panic(err)
    }
}

这段代码首先定义了一个

toUpper
函数,然后创建了一个
FuncMap
,把
toUpper
函数注册到里面,键名是"toUpper"。之后,创建模板的时候,通过
.Funcs(funcMap)
FuncMap
传进去。在模板里,就可以直接使用
{{ toUpper .Name }}
来调用这个函数了。

如何在Golang模板中处理复杂数据结构?

处理复杂数据结构的关键在于理解模板的“管道”概念。管道允许你将一个表达式的结果传递给另一个函数或表达式。这有点像流水线,数据在流水线上一步步处理。

例如,假设你有一个

User
结构体,里面有一个
Address
结构体,你需要访问
Address
里面的
City
字段。你可以这样:

package main

import (
    "fmt"
    "html/template"
    "os"
)

type Address struct {
    City string
}

type User struct {
    Name    string
    Address Address
}

func main() {
    tmpl, err := template.New("test").Parse(`
        用户 {{ .Name }} 住在 {{ .Address.City }}
    `)
    if err != nil {
        panic(err)
    }

    data := User{
        Name: "张三",
        Address: Address{
            City: "北京",
        },
    }

    err = tmpl.Execute(os.Stdout, data)
    if err != nil {
        panic(err)
    }
}

这里,

.Address.City
就是通过管道访问嵌套结构体的字段。 如果数据结构更复杂,你还可以结合自定义函数来处理,比如自定义一个函数来格式化地址信息。

Golang模板中的条件判断和循环技巧

条件判断和循环是模板中常用的控制结构。Go模板使用

{{ if ... }}
,
{{ else }}
,
{{ end }}
来进行条件判断,使用
{{ range ... }}
,
{{ end }}
来进行循环。

有道智云AI开放平台
有道智云AI开放平台

有道智云AI开放平台

下载

比如,你想根据用户的年龄来显示不同的消息:

package main

import (
    "fmt"
    "html/template"
    "os"
)

type User struct {
    Name string
    Age  int
}

func main() {
    tmpl, err := template.New("test").Parse(`
        {{ .Name }},
        {{ if gt .Age 18 }}
            你已经成年了。
        {{ else }}
            你还未成年。
        {{ end }}
    `)
    if err != nil {
        panic(err)
    }

    data := User{
        Name: "李四",
        Age:  20,
    }

    err = tmpl.Execute(os.Stdout, data)
    if err != nil {
        panic(err)
    }
}

这里,

{{ if gt .Age 18 }}
使用了内置的
gt
函数(greater than),判断年龄是否大于18。

循环的例子:

package main

import (
    "fmt"
    "html/template"
    "os"
)

func main() {
    tmpl, err := template.New("test").Parse(`
        {{ range . }}
            {{ . }}
        {{ end }}
    `)
    if err != nil {
        panic(err)
    }

    data := []string{"苹果", "香蕉", "橙子"}

    err = tmpl.Execute(os.Stdout, data)
    if err != nil {
        panic(err)
    }
}

这个例子循环遍历一个字符串切片,并输出每个元素。

如何避免Golang模板中的安全漏洞(例如XSS)?

避免XSS攻击的关键在于对用户输入进行适当的转义。Go模板默认会自动转义HTML,防止XSS攻击。但是,在某些情况下,你可能需要手动转义。

Go模板提供了几个转义函数:

  • html
    : 将字符串转义为HTML。
  • js
    : 将字符串转义为JavaScript。
  • urlquery
    : 将字符串转义为URL查询参数。

例如,如果你的模板中包含用户输入的HTML内容,你需要使用

html
函数进行转义:

package main

import (
    "fmt"
    "html/template"
    "os"
)

func main() {
    tmpl, err := template.New("test").Parse(`
        <div>
            用户输入:{{ .UserInput | html }}
        </div>
    `)
    if err != nil {
        panic(err)
    }

    data := struct {
        UserInput string
    }{
        UserInput: "<script>alert('XSS')</script>",
    }

    err = tmpl.Execute(os.Stdout, data)
    if err != nil {
        panic(err)
    }
}

这里,

{{ .UserInput | html }}
使用了
html
函数对用户输入进行转义,防止XSS攻击。 记住,永远不要信任用户输入,并始终进行适当的转义。 此外,尽量避免在模板中直接拼接字符串,因为这可能会引入安全漏洞。

如何在Golang模板中使用自定义的结构体方法?

你可以在模板中直接调用结构体的方法,这使得模板可以更方便地处理结构体数据。 前提是方法要是导出的(首字母大写)。

package main

import (
    "fmt"
    "html/template"
    "os"
)

type User struct {
    FirstName string
    LastName  string
}

// 定义一个结构体方法,返回用户的全名
func (u User) FullName() string {
    return u.FirstName + " " + u.LastName
}

func main() {
    tmpl, err := template.New("test").Parse(`
        {{ .FullName }}
    `)
    if err != nil {
        panic(err)
    }

    data := User{
        FirstName: "张",
        LastName:  "三",
    }

    err = tmpl.Execute(os.Stdout, data)
    if err != nil {
        panic(err)
    }
}

这里,

{{ .FullName }}
直接调用了
User
结构体的
FullName
方法。 这种方式可以让你在模板中更方便地处理结构体数据,而不需要定义额外的模板函数。

热门AI工具

更多
DeepSeek
DeepSeek

幻方量化公司旗下的开源大模型平台

豆包大模型
豆包大模型

字节跳动自主研发的一系列大型语言模型

通义千问
通义千问

阿里巴巴推出的全能AI助手

腾讯元宝
腾讯元宝

腾讯混元平台推出的AI助手

文心一言
文心一言

文心一言是百度开发的AI聊天机器人,通过对话可以生成各种形式的内容。

讯飞写作
讯飞写作

基于讯飞星火大模型的AI写作工具,可以快速生成新闻稿件、品宣文案、工作总结、心得体会等各种文文稿

即梦AI
即梦AI

一站式AI创作平台,免费AI图片和视频生成。

ChatGPT
ChatGPT

最最强大的AI聊天机器人程序,ChatGPT不单是聊天机器人,还能进行撰写邮件、视频脚本、文案、翻译、代码等任务。

相关专题

更多
golang如何定义变量
golang如何定义变量

golang定义变量的方法:1、声明变量并赋予初始值“var age int =值”;2、声明变量但不赋初始值“var age int”;3、使用短变量声明“age :=值”等等。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

210

2024.02.23

golang有哪些数据转换方法
golang有哪些数据转换方法

golang数据转换方法:1、类型转换操作符;2、类型断言;3、字符串和数字之间的转换;4、JSON序列化和反序列化;5、使用标准库进行数据转换;6、使用第三方库进行数据转换;7、自定义数据转换函数。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

247

2024.02.23

golang常用库有哪些
golang常用库有哪些

golang常用库有:1、标准库;2、字符串处理库;3、网络库;4、加密库;5、压缩库;6、xml和json解析库;7、日期和时间库;8、数据库操作库;9、文件操作库;10、图像处理库。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

356

2024.02.23

golang和python的区别是什么
golang和python的区别是什么

golang和python的区别是:1、golang是一种编译型语言,而python是一种解释型语言;2、golang天生支持并发编程,而python对并发与并行的支持相对较弱等等。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

214

2024.03.05

golang是免费的吗
golang是免费的吗

golang是免费的。golang是google开发的一种静态强类型、编译型、并发型,并具有垃圾回收功能的开源编程语言,采用bsd开源协议。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

409

2024.05.21

golang结构体相关大全
golang结构体相关大全

本专题整合了golang结构体相关大全,想了解更多内容,请阅读专题下面的文章。

490

2025.06.09

golang相关判断方法
golang相关判断方法

本专题整合了golang相关判断方法,想了解更详细的相关内容,请阅读下面的文章。

201

2025.06.10

golang数组使用方法
golang数组使用方法

本专题整合了golang数组用法,想了解更多的相关内容,请阅读专题下面的文章。

1438

2025.06.17

C# ASP.NET Core微服务架构与API网关实践
C# ASP.NET Core微服务架构与API网关实践

本专题围绕 C# 在现代后端架构中的微服务实践展开,系统讲解基于 ASP.NET Core 构建可扩展服务体系的核心方法。内容涵盖服务拆分策略、RESTful API 设计、服务间通信、API 网关统一入口管理以及服务治理机制。通过真实项目案例,帮助开发者掌握构建高可用微服务系统的关键技术,提高系统的可扩展性与维护效率。

3

2026.03.11

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
golang socket 编程
golang socket 编程

共2课时 | 0.1万人学习

nginx浅谈
nginx浅谈

共15课时 | 0.9万人学习

golang和swoole核心底层分析
golang和swoole核心底层分析

共3课时 | 0.2万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号