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

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

news 2025/9/15 4:32:57

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 框架中，模板引擎的配置通过以下步骤完成：

  1. 加载模板文件。
  2. 在路由中使用 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>
模板语法说明
  1. {{ .变量名 }}：用于输出变量值。
  2. 模板中的 .变量名 对应 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 框架支持动态网页开发&#xff0c;能够通过模板渲染结合数据生成动态页面。在这篇文章中&#xff0c;我们将一步步学习如何在 Gin 框架中配置模板、渲染动态数据&#xff0c;并结合静态资源文件创建一个功能完整的动态网站。 文章目录 1. 什么是模板渲染&#xff1f;1.1 概…...

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

CSS:导航栏三角箭头

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

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

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

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

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

QSS 设置bug

问题描述&#xff1a; 在QWidget上add 一个QLabel&#xff0c;但是死活不生效 原因&#xff1a; c 主程序如下&#xff1a; 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年提出的一种二叉树结构的交换排序方法&#xff08;下文简称快排&#xff09;&#xff0c;其基本思想为&a…...

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

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

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

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

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

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

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

gorm框架

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

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

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

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

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

【ASR技术】WhisperX安装使用

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

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

【计算机网络】协议定制

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

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

【SQL】mysql常用命令

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

nfs服务器--RHCE

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

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

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

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

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

Javascript高级—函数柯西化

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

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

ssc377d修改flash分区大小

1、flash的分区默认分配16M、 / # df -h Filesystem Size Used Available Use% Mounted on /dev/root 1.9M 1.9M 0 100% / /dev/mtdblock4 3.0M...

编程新知 2025/8/4 2:45:15

聊聊 Pulsar：Producer 源码解析

一、前言 Apache Pulsar 是一个企业级的开源分布式消息传递平台&#xff0c;以其高性能、可扩展性和存储计算分离架构在消息队列和流处理领域独树一帜。在 Pulsar 的核心架构中&#xff0c;Producer&#xff08;生产者&#xff09; 是连接客户端应用与消息队列的第一步。生产者…...

编程新知 2025/9/9 15:02:26

Java 加密常用的各种算法及其选择

在数字化时代&#xff0c;数据安全至关重要&#xff0c;Java 作为广泛应用的编程语言&#xff0c;提供了丰富的加密算法来保障数据的保密性、完整性和真实性。了解这些常用加密算法及其适用场景&#xff0c;有助于开发者在不同的业务需求中做出正确的选择。​ 一、对称加密算法…...

编程新知 2025/7/7 7:20:27

NLP学习路线图（二十三）：长短期记忆网络（LSTM）

在自然语言处理（NLP）领域，我们时刻面临着处理序列数据的核心挑战。无论是理解句子的结构、分析文本的情感，还是实现语言的翻译，都需要模型能够捕捉词语之间依时序产生的复杂依赖关系。传统的神经网络结构在处理这种序列依赖时显得力不从心，而循环神经网络（RNN） 曾被视为…...

编程新知 2025/9/3 5:05:40

基于Java Swing的电子通讯录设计与实现：附系统托盘功能代码详解

JAVASQL电子通讯录带系统托盘 一、系统概述 本电子通讯录系统采用Java Swing开发桌面应用&#xff0c;结合SQLite数据库实现联系人管理功能&#xff0c;并集成系统托盘功能提升用户体验。系统支持联系人的增删改查、分组管理、搜索过滤等功能&#xff0c;同时可以最小化到系统…...

编程新知 2025/6/15 22:59:29

算法：模拟

1.替换所有的问号 1576. 替换所有的问号 - 力扣&#xff08;LeetCode&#xff09; ​遍历字符串​&#xff1a;通过外层循环逐一检查每个字符。​遇到 ? 时处理​&#xff1a; 内层循环遍历小写字母&#xff08;a 到 z&#xff09;。对每个字母检查是否满足&#xff1a; ​与…...

编程新知 2025/9/3 20:40:45

MFC 抛体运动模拟：常见问题解决与界面美化

在 MFC 中开发抛体运动模拟程序时，我们常遇到 轨迹残留、无效刷新、视觉单调、物理逻辑瑕疵 等问题。本文将针对这些痛点，详细解析原因并提供解决方案，同时兼顾界面美化，让模拟效果更专业、更高效。 问题一：历史轨迹与小球残影残留 现象 小球运动后，历史位置的 “残影”…...

编程新知 2025/9/14 22:39:28

Kafka主题运维全指南：从基础配置到故障处理

#作者&#xff1a;张桐瑞 文章目录 主题日常管理1. 修改主题分区。2. 修改主题级别参数。3. 变更副本数。4. 修改主题限速。5.主题分区迁移。6. 常见主题错误处理常见错误1&#xff1a;主题删除失败。常见错误2&#xff1a;__consumer_offsets占用太多的磁盘。 主题日常管理 …...

编程新知 2025/6/10 21:14:43

在树莓派上添加音频输入设备的几种方法

在树莓派上添加音频输入设备可以通过以下步骤完成&#xff0c;具体方法取决于设备类型&#xff08;如USB麦克风、3.5mm接口麦克风或HDMI音频输入&#xff09;。以下是详细指南&#xff1a; 1. 连接音频输入设备 USB麦克风/声卡&#xff1a;直接插入树莓派的USB接口。3.5mm麦克…...

编程新知 2025/7/8 17:49:38

MySQL的pymysql操作

本章是MySQL的最后一章&#xff0c;MySQL到此完结&#xff0c;下一站Hadoop&#xff01;&#xff01;&#xff01; 这章很简单&#xff0c;完整代码在最后&#xff0c;详细讲解之前python课程里面也有&#xff0c;感兴趣的可以往前找一下 一、查询操作 我们需要打开pycharm …...

编程新知 2025/9/5 23:31:07