Go Web开发框架实践:模板渲染与静态资源服务

Gin 不仅适合构建 API 服务,也支持 HTML 模板渲染和静态资源托管,使其可以胜任中小型网站开发任务。


一、模板渲染基础

1. 加载模板文件

使用 LoadHTMLGlobLoadHTMLFiles 方法加载模板:

css 复制代码
r := gin.Default()
r.LoadHTMLGlob("templates/*") // 支持通配符

或:

arduino 复制代码
r.LoadHTMLFiles("templates/index.tmpl", "templates/user.tmpl")

2. 定义模板文件(templates/index.tmpl)

xml 复制代码
<!DOCTYPE html>
<html>
<head>
    <title>{{ .Title }}</title>
</head>
<body>
    <h1>Hello, {{ .User }}</h1>
</body>
</html>

3. 渲染模板响应

go 复制代码
r.GET("/", func(c *gin.Context) {
    c.HTML(200, "index.tmpl", gin.H{
        "Title": "首页",
        "User":  "Gopher",
    })
})

二、模板语法简介(兼容 Go 的 html/template)

1. 输出变量

css 复制代码
<p>{{ .Name }}</p>

2. 条件语句

css 复制代码
{{ if .Login }}
    <p>Welcome back!</p>
{{ else }}
    <p>Please login.</p>
{{ end }}

3. 循环遍历

css 复制代码
<ul>
    {{ range .Items }}
        <li>{{ . }}</li>
    {{ end }}
</ul>

4. 使用管道函数

css 复制代码
<p>{{ .Content | html }}</p>

三、自定义模板函数

go 复制代码
r.SetFuncMap(template.FuncMap{
    "formatDate": func(t time.Time) string {
        return t.Format("2006-01-02")
    },
})
r.LoadHTMLGlob("templates/*")

模板中使用:

css 复制代码
<p>发布日期:{{ .CreatedAt | formatDate }}</p>

四、静态资源服务

1. 基础静态目录映射

/static 路径映射到本地 assets 目录:

vbnet 复制代码
r.Static("/static", "./assets")

访问方式:

bash 复制代码
http://localhost:8080/static/css/style.css

2. 映射单个文件(如 favicon)

arduino 复制代码
r.StaticFile("/favicon.ico", "./assets/favicon.ico")

五、模板热重载(开发调试推荐)

开发阶段可使用第三方工具(如 air)实现模板与代码热重载,提升效率。

安装:

bash 复制代码
go install github.com/cosmtrek/air@latest

运行:

复制代码
air

六、示例:构建一个带静态资源和模板页面的简单博客首页

go 复制代码
func main() {
    r := gin.Default()
    r.LoadHTMLGlob("templates/*")
    r.Static("/static", "./assets")

    r.GET("/", func(c *gin.Context) {
        posts := []string{"Go 入门", "Gin 实战", "部署技巧"}
        c.HTML(200, "index.tmpl", gin.H{
            "Title": "Golang 博客",
            "Posts": posts,
        })
    })

    r.Run()
}

模板内容:templates/index.tmpl

xml 复制代码
<!DOCTYPE html>
<html>
<head>
    <title>{{ .Title }}</title>
    <link rel="stylesheet" href="/static/css/style.css">
</head>
<body>
    <h1>{{ .Title }}</h1>
    <ul>
        {{ range .Posts }}
            <li>{{ . }}</li>
        {{ end }}
    </ul>
</body>
</html>

七、小结

功能 优点说明
模板渲染 使用 Go 原生 html/template,安全高效
支持条件与循环 动态页面结构易于控制
静态资源托管 支持 JS、CSS、图片等静态内容一键映射
自定义模板函数 灵活扩展渲染逻辑

相关推荐
武子康3 小时前
Java-80 深入浅出 RPC Dubbo 动态服务降级:从雪崩防护到配置中心秒级生效
java·分布式·后端·spring·微服务·rpc·dubbo
舒一笑4 小时前
我的开源项目-PandaCoder迎来史诗级大更新啦
后端·程序员·intellij idea
@昵称不存在5 小时前
Flask input 和datalist结合
后端·python·flask
zhuyasen5 小时前
Go 分布式任务和定时任务太难?sasynq 让异步任务从未如此简单
后端·go
东林牧之5 小时前
Django+celery异步:拿来即用,可移植性高
后端·python·django
超浪的晨6 小时前
Java UDP 通信详解:从基础到实战,彻底掌握无连接网络编程
java·开发语言·后端·学习·个人开发
AntBlack6 小时前
从小不学好 ,影刀 + ddddocr 实现图片验证码认证自动化
后端·python·计算机视觉
Pomelo_刘金7 小时前
Clean Architecture 整洁架构:借一只闹钟讲明白「整洁架构」的来龙去脉
后端·架构·rust
双力臂4047 小时前
Spring Boot 单元测试进阶:JUnit5 + Mock测试与切片测试实战及覆盖率报告生成
java·spring boot·后端·单元测试
midsummer_woo8 小时前
基于spring boot的医院挂号就诊系统(源码+论文)
java·spring boot·后端