当前位置：首页 > news >正文

【Golang】——Gin 框架中的模板渲染详解

news 2026/2/8 6:47:46

Gin 框架支持动态网页开发，能够通过模板渲染结合数据生成动态页面。在这篇文章中，我们将一步步学习如何在 Gin 框架中配置模板、渲染动态数据，并结合静态资源文件创建一个功能完整的动态网站。

文章目录

- 1. 什么是模板渲染？
- - 1.1 概念介绍
  - 1.2 Gin 中的模板渲染
- 2. Gin 模板渲染基础
- - 2.1 配置模板引擎
  - - 示例代码
    - 说明
  - 2.2 创建模板文件
  - - 模板语法说明
  - 2.3 使用 `LoadHTMLFiles` 方法
- 3. 模板渲染进阶
- - 3.1 条件判断
  - - 示例模板
    - 示例数据
  - 3.2 循环处理
  - - 示例模板
    - 示例数据
  - 3.3 嵌套模板
  - - 基础模板 `layout.html`
    - 子模板 `home.html`
    - 渲染嵌套模板
- 4. 静态文件的处理
- - 4.1 配置静态文件服务
  - 4.2 在模板中引用静态文件
  - - 示例静态文件
- 5. 实战：简易博客项目
- - 5.1 项目结构
  - 5.2 完整代码
- 6. 总结

在这里插入图片描述

1. 什么是模板渲染？

1.1 概念介绍

模板渲染是一种动态生成 HTML 页面的技术。通过模板文件和动态数据的结合，Web 应用可以为每个用户生成不同的内容。模板渲染的主要作用包括：

数据与视图分离：HTML 文件专注于页面结构和样式，动态数据由代码逻辑控制。
代码复用：通过模板复用页面组件（如导航栏、页脚等）。
维护便利：HTML 和业务逻辑分开，降低了代码维护的复杂性。

1.2 Gin 中的模板渲染

Gin 使用 Go 标准库 html/template 提供模板功能。html/template 是一套基于 HTML 的安全模板引擎，避免了常见的跨站脚本攻击 (XSS)。

2. Gin 模板渲染基础

2.1 配置模板引擎

在 Gin 框架中，模板引擎的配置通过以下步骤完成：

加载模板文件。
在路由中使用 c.HTML() 渲染模板。

示例代码

package mainimport "github.com/gin-gonic/gin"func main() {r := gin.Default()// 1. 加载模板文件r.LoadHTMLGlob("templates/*")// 2. 定义路由r.GET("/", func(c *gin.Context) {c.HTML(200, "index.html", gin.H{"Title": "Gin 模板示例","Message": "欢迎来到 Gin 的世界！",})})// 3. 启动服务器r.Run(":8080")
}

说明

LoadHTMLGlob("templates/*")：加载 templates 文件夹下的所有 .html 文件。
c.HTML(200, "index.html", gin.H{"key": "value"})：渲染模板，传递键值对形式的数据。

2.2 创建模板文件

在项目根目录下创建 templates/index.html 文件，内容如下：

<!DOCTYPE html>
<html lang="en">
<head><meta charset="UTF-8"><meta name="viewport" content="width=device-width, initial-scale=1.0"><title>{{ .Title }}</title>
</head>
<body><h1>{{ .Message }}</h1>
</body>
</html>

模板语法说明

{{ .变量名 }}：用于输出变量值。
模板中的 .变量名 对应 gin.H 中的键。

运行程序后，访问 http://localhost:8080，浏览器将显示模板渲染的内容。

2.3 使用 `LoadHTMLFiles` 方法

LoadHTMLFiles 用于加载指定的模板文件，而不是整个目录：

r.LoadHTMLFiles("templates/index.html", "templates/about.html")

适用于模板文件较少且明确的情况。

3. 模板渲染进阶

Gin 模板渲染支持条件判断、循环、嵌套等功能。下面逐一讲解这些功能的实现方式。

3.1 条件判断

条件判断通过 {{ if }} 实现，可以搭配 {{ else }} 或 {{ else if }}。

示例模板

<h1>{{ .Title }}</h1>
{{ if .IsAdmin }}
<p>欢迎，管理员！</p>
{{ else }}
<p>欢迎，普通用户！</p>
{{ end }}

示例数据

c.HTML(200, "index.html", gin.H{"Title": "条件判断示例","IsAdmin": true,
})

当 IsAdmin 为 true 时，显示“欢迎，管理员！”。

3.2 循环处理

通过 {{ range }} 遍历数组或切片：

示例模板

<ul>{{ range .Items }}<li>{{ . }}</li>{{ end }}
</ul>

示例数据

c.HTML(200, "index.html", gin.H{"Items": []string{"苹果", "香蕉", "橙子"},
})

渲染结果为：

<ul><li>苹果</li><li>香蕉</li><li>橙子</li>
</ul>

3.3 嵌套模板

嵌套模板允许你将页面分为多个组件，例如公共的头部和尾部。

基础模板 `layout.html`

<!DOCTYPE html>
<html lang="en">
<head><title>{{ .Title }}</title>
</head>
<body><header>公共头部</header>{{ template "content" . }}<footer>公共尾部</footer>
</body>
</html>

子模板 `home.html`

{{ define "content" }}
<h1>{{ .Message }}</h1>
{{ end }}

渲染嵌套模板

r.GET("/", func(c *gin.Context) {c.HTML(200, "layout.html", gin.H{"Title": "嵌套模板示例","Message": "欢迎使用嵌套模板！",})
})

模板 layout.html 会自动嵌入子模板内容。

4. 静态文件的处理

4.1 配置静态文件服务

静态文件（如 CSS、JS、图片）通过 Static() 方法加载：

r.Static("/static", "./static")

此代码将项目中的 static 文件夹映射到 URL 路径 /static。

4.2 在模板中引用静态文件

<link rel="stylesheet" href="/static/style.css">
<script src="/static/app.js"></script>

示例静态文件

static/style.css：

body {font-family: Arial, sans-serif;background-color: #f5f5f5;
}

在这里插入图片描述

5. 实战：简易博客项目

5.1 项目结构

├── main.go
├── static
│   └── style.css
├── templates
│   ├── layout.html
│   ├── home.html
│   ├── post.html

5.2 完整代码

package mainimport ("github.com/gin-gonic/gin"
)type Post struct {ID      intTitle   stringContent string
}var posts = []Post{{1, "第一篇博客", "这是第一篇博客内容。"},{2, "第二篇博客", "这是第二篇博客内容。"},
}func main() {r := gin.Default()// 配置模板和静态文件r.LoadHTMLGlob("templates/*")r.Static("/static", "./static")// 首页路由r.GET("/", func(c *gin.Context) {c.HTML(200, "layout.html", gin.H{"Title": "首页","Posts": posts,})})// 文章详情路由r.GET("/post/:id", func(c *gin.Context) {id := c.Param("id")for _, post := range posts {if string(post.ID) == id {c.HTML(200, "layout.html", gin.H{"Title":   post.Title,"Content": post.Content,})return}}c.String(404, "文章未找到")})r.Run(":8080")
}

运行后访问 http://localhost:8080，你将看到一个支持文章列表和详情页的简单博客。

6. 总结

本篇博客从模板渲染的基础配置，到嵌套模板、静态文件服务，以及完整项目实战，全面展示了 Gin 框架在动态网页开发中的强大能力。下一篇，我们将学习表单处理与数据绑定，进一步丰富你的 Web 应用开发技能。

【Golang】——Gin 框架中的模板渲染详解

Gin 框架支持动态网页开发，能够通过模板渲染结合数据生成动态页面。在这篇文章中，我们将一步步学习如何在 Gin 框架中配置模板、渲染动态数据，并结合静态资源文件创建一个功能完整的动态网站。文章目录 1. 什么是模板渲染？1.1 概…...

编程日记 2024/11/19 2:22:58

CSS:导航栏三角箭头

用CSS实现导航流程图的样式。可根据自己的需求进行修改，代码精略的写了一下。注：场景一和场景二在分辨率比较低的情况下会有一个1px的缝隙不太优雅，自行处理。有个方法是直接在每个外面包一个DIV，用动态样式设置底色。场景一、…...

编程日记 2024/11/19 2:15:51

onlyoffice Command service(命令服务)使用示例

一、说明文档在这里：https://api.onlyoffice.com/docs/docs-api/additional-api/command-service/ 命令服务提供有几个简单的接口封装。也提供了前端和后端同时操作文档的可能。二、正文命令服务地址：https://documentserver/coauthoring/Com…...

编程日记 2024/11/19 2:12:49

QSS 设置bug

问题描述： 在QWidget上add 一个QLabel，但是死活不生效原因： c 主程序如下： QWidget* LOGO new QWidget(logo_wnd);LOGO->setFixedSize(logo_width, 41);LOGO->setObjectName("TittltLogo");QVBoxLayout* tit…...

编程日记 2024/11/19 2:08:43

交换排序——快速排序

交换排序——快速排序 7.7 交换排序——快速排序快速排序概念c语言的库函数qsort快速排序框架quickSort 7.7 交换排序——快速排序快速排序概念快速排序是Hoare于1962年提出的一种二叉树结构的交换排序方法（下文简称快排），其基本思想为&a…...

编程日记 2024/11/19 2:05:39

nodejs入门（1）：nodejs的前后端分离

一、引言我关注nodejs还是从前几年做了的一个电力大数据展示系统开始的，当然，我肯定是很多年的计算机基础的，万变不离其宗。现在web网站都流行所谓的前后端结构，不知不觉我也开始受到这个影响，以前都是前端直接操作…...

编程日记 2024/11/19 2:03:37

笔记｜M芯片MAC (arm64) docker上使用 export / import / commit 构建amd64镜像

很简单的起因，我的东西最终需要跑在amd64上，但是因为mac的架构师arm64，所以直接构建好的代码是没办法跨平台运行的。直接在arm64上pull下来的docker镜像也都是arm64架构。检查镜像架构： docker inspect 8135f475e221 | grep Arc…...

编程日记 2024/11/19 1:53:26

gorm框架

连接需要下载mysql的驱动 go get gorm.io/driver/mysql go get gorm.io/gorm 约定主键：GORM 使用一个名为ID 的字段作为每个模型的默认主键。表名：默认情况下，GORM 将结构体名称转换为 snake_case 并为表名加上复数形式。例如&#xf…...

编程日记 2024/11/19 1:52:25

免费送源码：Java+Springboot+MySQL Springboot多租户博客网站的设计计算机毕业设计原创定制

Springboot多租户博客网站的设计摘要博客网站是当今网络的热点，博客技术的出现使得每个人可以零成本、零维护地创建自己的网络媒体，Blog站点所形成的网状结构促成了不同于以往社区的Blog文化，Blog技术缔造了“博客”文化。本文课题研究的“…...

编程日记 2024/11/19 1:49:20

【ASR技术】WhisperX安装使用

介绍 WhisperX 是一个开源的自动语音识别（ASR）项目，由 m-bain 开发。该项目基于 OpenAI 的 Whisper 模型，通过引入批量推理、强制音素对齐和语音活动检测等技术。提供快速自动语音识别（large-v2 为 70 倍实时&#xf…...

编程日记 2024/11/19 1:48:19

【计算机网络】协议定制

一、结构化数据传输流程这里涉及协议定制、序列化/反序列化的知识对于序列化和反序列化，有现成的解决方案：①json ②probuff ③xml 二、理解发送接收函数我们调用的所有发送/接收函数，根本就不是把数据发送到网络中！本质都是…...

编程日记 2024/11/19 1:46:16

【SQL】mysql常用命令

为方便查询，特整理MySQL常用命令。约定：$后为Shell环境命令，>后为MySQL命令。 1 常用命令第一步，连接数据库。 $ mysql -u root -p # 进入MySQL bin目录后执行，回车后输入密码连接。# 常用参数&…...

编程日记 2024/11/19 1:45:14

阿里云引领智算集群网络架构的新一轮变革

阿里云引领智算集群网络架构的新一轮变革云布道师 11 月 8 日~ 10 日在江苏张家港召开的 CCF ChinaNet（即中国网络大会）上，众多院士、教授和业界技术领袖齐聚一堂，畅谈网络未来的发展方向，聚焦智算集群网络的创新变…...

编程日记 2024/11/19 1:42:12

几何合理的分片段感知的3D分子生成 FragGen - 评测

FragGen 来源于 2024 年 3 月 25 日预印本的文章，文章题目是 Deep Geometry Handling and Fragment-wise Molecular 3D Graph Generation， 作者是 Odin Zhang，侯廷军，浙江大学药学院。FragGen 是一个基于分子片段的 3D 分子生成模…...

编程日记 2024/11/19 1:41:11

Python爬虫下载新闻，Flask展现新闻（2）

上篇讲了用Python从新闻网站上下载新闻，本篇讲用Flask展现新闻。关于Flask安装网上好多教程，不赘述。下面主要讲 HTML-Flask-数据的关系。简洁版如图，页面简单，主要显示新闻标题。分页，使用最简单的分页技术&…...

编程日记 2024/11/19 1:38:08

监控易监测对象及指标之：全面监控华为FusionInsight服务

随着大数据技术的广泛应用，华为FusionInsight以其卓越的性能和稳定性，成为了众多企业处理和分析海量数据的首选平台。然而，为了确保FusionInsight服务的持续稳定运行，对其进行全面监控至关重要。本文基于监控易工具，对…...

编程日记 2024/11/19 1:37:07

SQL面试题——蚂蚁SQL面试题会话分组问题

会话分组问题这里的分组不是简单的分组，而是会话的分组。比如说，进入一个网站以后，可以连续的点击很多个页面，后台会记录用户的行为日志；如果T日上午连续点击几个页面后退出了网站，直到第二天的下午才再次进入网站，单单从时间线上来看，昨天退出的那条日志跟今天进…...

编程日记 2024/11/19 1:36:06

nfs服务器--RHCE

一，简介 NFS（Network File System，网络文件系统）是FreeBSD支持的文件系统中的一种，它允许网络中的计算机（不同的计算机、不同的操作系统）之间通过TCP/IP网络共享资源，主要在unix系…...

编程日记 2024/11/19 1:33:01

React--》如何高效管理前端环境变量：开发与生产环境配置详解

在前端开发中，如何让项目在不同环境下表现得更为灵活与高效，是每个开发者必须面对的挑战，从开发阶段的调试到生产环境的优化，环境变量配置无疑是其中的关键。 env配置文件：通常用于管理项目的环境变量，环境…...

编程日记 2024/11/19 1:24:53

Javascript高级—函数柯西化

函数柯西化（经典面试题） // 实现一个add方法，使计算结果能够满足如下预期： add(1)(2)(3) 6; add(1, 2, 3)(4) 10; add(1)(2)(3)(4)(5) 15;function add() {// 第一次执行时，定义一个数组专门用来存储所有的参数var…...

编程日记 2024/11/19 1:20:42

eNSP-Cloud(实现本地电脑与eNSP内设备之间通信)

说明： 想象一下，你正在用eNSP搭建一个虚拟的网络世界，里面有虚拟的路由器、交换机、电脑（PC）等等。这些设备都在你的电脑里面“运行”，它们之间可以互相通信，就像一个封闭的小王国。但是&#…...

编程新知 2026/2/8 4:37:17

在软件开发中正确使用MySQL日期时间类型的深度解析

在日常软件开发场景中，时间信息的存储是底层且核心的需求。从金融交易的精确记账时间、用户操作的行为日志，到供应链系统的物流节点时间戳，时间数据的准确性直接决定业务逻辑的可靠性。MySQL作为主流关系型数据库，其日期时间类型的…...

编程新知 2025/10/16 13:22:06

【杂谈】-递归进化：人工智能的自我改进与监管挑战

递归进化：人工智能的自我改进与监管挑战文章目录递归进化：人工智能的自我改进与监管挑战1、自我改进型人工智能的崛起2、人工智能如何挑战人类监管？3、确保人工智能受控的策略4、人类在人工智能发展中的角色5、平衡自主性与控制力6、总结与…...

编程新知 2025/12/9 0:22:01

【JavaEE】-- HTTP

1. HTTP是什么？ HTTP（全称为"超文本传输协议"）是一种应用非常广泛的应用层协议，HTTP是基于TCP协议的一种应用层协议。应用层协议：是计算机网络协议栈中最高层的协议，它定义了运行在不同主机上…...

编程新知 2026/1/26 21:34:05

Fabric V2.5 通用溯源系统——增加图片上传与下载功能

fabric-trace项目在发布一年后，部署量已突破1000次，为支持更多场景，现新增支持图片信息上链，本文对图片上传、下载功能代码进行梳理，包含智能合约、后端、前端部分。一、智能合约修改为了增加图片信息上链溯源，需要对底层数据结构进行修改，在此对智能合约中的农产品数…...

编程新知 2025/9/27 12:03:43

代码随想录刷题day30

1、零钱兑换II 给你一个整数数组 coins 表示不同面额的硬币，另给一个整数 amount 表示总金额。请你计算并返回可以凑成总金额的硬币组合数。如果任何硬币组合都无法凑出总金额，返回 0 。假设每一种面额的硬币有无限个。题目数据保证结果符合 32 位带…...

编程新知 2025/10/4 6:30:56

IP如何挑？2025年海外专线IP如何购买？

你花了时间和预算买了IP，结果IP质量不佳，项目效率低下不说，还可能带来莫名的网络问题，是不是太闹心了？尤其是在面对海外专线IP时，到底怎么才能买到适合自己的呢？所以，挑IP绝对是个技…...

编程新知 2026/1/28 3:04:35

Python基于历史模拟方法实现投资组合风险管理的VaR与ES模型项目实战

说明：这是一个机器学习实战项目（附带数据代码文档），如需数据代码文档可以直接到文章最后关注获取。 1.项目背景在金融市场日益复杂和波动加剧的背景下，风险管理成为金融机构和个人投资者关注的核心议题之一。VaR&…...

编程新知 2026/1/25 4:19:49

MySQL 知识小结（一）

一、my.cnf配置详解我们知道安装MySQL有两种方式来安装咱们的MySQL数据库，分别是二进制安装编译数据库或者使用三方yum来进行安装,第三方yum的安装相对于二进制压缩包的安装更快捷，但是文件存放起来数据比较冗余，用二进制能够更好管理咱们M…...

编程新知 2026/1/26 13:29:47

Kubernetes 网络模型深度解析：Pod IP 与 Service 的负载均衡机制，Service到底是什么？

Pod IP 的本质与特性 Pod IP 的定位纯端点地址：Pod IP 是分配给 Pod 网络命名空间的真实 IP 地址（如 10.244.1.2）无特殊名称：在 Kubernetes 中，它通常被称为 “Pod IP” 或 “容器 IP”生命周期：与 Pod …...

编程新知 2025/11/4 22:48:45

文章目录

1. 什么是模板渲染？

1.1 概念介绍

1.2 Gin 中的模板渲染

2. Gin 模板渲染基础

2.1 配置模板引擎

示例代码

说明

2.2 创建模板文件

模板语法说明

2.3 使用 LoadHTMLFiles 方法

3. 模板渲染进阶

3.1 条件判断

示例模板

示例数据

3.2 循环处理

示例模板

示例数据

3.3 嵌套模板

基础模板 layout.html

子模板 home.html

渲染嵌套模板

4. 静态文件的处理

4.1 配置静态文件服务

4.2 在模板中引用静态文件

示例静态文件

5. 实战：简易博客项目

5.1 项目结构

5.2 完整代码

6. 总结

相关文章：

2.3 使用 `LoadHTMLFiles` 方法

基础模板 `layout.html`

子模板 `home.html`