跳到主要内容
Go Web 基础操作与模版引擎入门指南 | 极客日志
Go / Golang
Go Web 基础操作与模版引擎入门指南 综述由AI生成 Go 语言 Web 开发的基础操作，包括单/多控制器配置、请求头与参数获取、表单验证、项目结构搭建。详细讲解了 html/template 包的使用，涵盖数据传递（字符串、结构体、Map）、自定义函数调用、条件判断与循环、模版嵌套。此外还包含静态资源加载、文件上传与下载的实现方法，并修正了部分旧 API 用法。
微码行者 发布于 2026/4/5 更新于 2026/5/24 Web 操作
单控制器和多控制器
单控制器
type MyHandle struct {}
func (m *MyHandle) "返回的数据哈哈" )
}
func main () ":8090" , Handler: &h}
server.ListenAndServe()
}
多控制器
在实际开发中，大部分情况不应该只有一个控制器，不同的请求应该交给不同的处理单元。在 Golang 中支持两种多处理方式：
多个处理器 (Handle)
多个处理函数 (HandleFunc)
1、多处理器
即使用 http.Handle 把不同的 URL 绑定到不同的处理器中。
type MyHandle struct {}
type MyOtherHandle struct {}
func (m *MyHandle) "返回的数据哈哈" )
}
func (m *MyOtherHandle) "返回的数据哈哈" )
}
func main () "/a" , &h)
http.Handle("/abc" , &h2)
http.ListenAndServe(":8090" , nil )
}
2、多处理函数
把不同的 URL 绑定到不同的函数上。
func
first
(w http.ResponseWriter, r *http.Request)
"多处理函数--first"
func second (w http.ResponseWriter, r *http.Request)
"多处理函数--second"
func main ()
"/f"
"/s"
":8090"
nil
获取请求头和获取请求参数
1、获取请求头 func now (w http.ResponseWriter, r *http.Request) "Accept-Encoding" ])
fmt.Println(len (h["Accept-Encoding" ]))
}
func main () "/now" , now)
http.ListenAndServe(":9090" , nil )
}
2、获取请求参数 func now (w http.ResponseWriter, r *http.Request) "url_long" ])
fmt.Println(r.Form["url_long" ][0 ])
}
func main () "/now" , now)
http.ListenAndServe(":9090" , nil )
}
3、验证表单的输入
if m, _ := regexp.MatchString(`^(1[3|4|5|8][0-9]\d{4,8})$` , r.Form.Get("mobile" )); !m {
return false
}
Web 项目结构
HTML 模版和静态资源显示
1、HTML 模版显示 Go 语言标准库中 html/template 包提供了 HTML 模版支持，把 HTML 当作模版可以在访问控制器时显示 HTML 模版信息。
使用 template.ParseFiles() 可以解析多个模版文件。
func welcome (w http.ResponseWriter, r *http.Request) "view/index.html" )
t.Execute(w, nil )
}
func main () "/" , welcome)
http.ListenAndServe(":9090" , nil )
}
2、静态资源显示 把静态资源文件放到特定的文件夹中，使用 Go 语言的文件服务就可以进行加载。
func welcome (w http.ResponseWriter, r *http.Request) "view/index.html" )
t.Execute(w, nil )
}
func main () "/" , welcome)
http.Handle("/static/" , http.StripPrefix("/static/" , http.FileServer(http.Dir("static" ))))
http.ListenAndServe(":9090" , nil )
}
向模版中传递数据和调用函数
一、向模版中传递数据
可以在 HTML 中使用 {{}} 获取 template.Execute() 第二个参数传递的值。
最常用的 {{.}} 中的 . 是指针，指向当前变量，成为 "dot"。
1、字符串类型 func welcome (w http.ResponseWriter, r *http.Request) "view/index.html" )
t.Execute(w, "smallming" )
}
func main () "/" , welcome)
http.ListenAndServe(":9090" , nil )
}
<body >
<pre > 尊敬的{{.}}先生/女士 您已经被我公司录取。</pre >
</body >
2、结构体类型 type User struct {
Name string
Age int
}
func welcome (w http.ResponseWriter, r *http.Request) "view/index.html" )
t.Execute(w, User{"张三" , 19 })
}
func main () "/" , welcome)
http.ListenAndServe(":9090" , nil )
}
<body >
<pre > 姓名：{{.Name}}<br /> 年龄：{{.Age}}</pre >
</body >
PS：结构体的字段一定要首字母大写，否则模版访问不到。
3、map 类型 type User struct {
Name string
Age int
}
func welcome (w http.ResponseWriter, r *http.Request) "view/index.html" )
m := make (map [string ]interface {})
m["user" ] = User{"张三" , 19 }
m["money" ] = 1000
t.Execute(w, m)
}
func main () "/" , welcome)
http.ListenAndServe(":9090" , nil )
}
<body >
<pre > 姓名：{{.user.Name}}<br /> 年龄：{{.user.Age}}<br /> 工资：{{.money}}</pre >
</body >
二、在模版中调用函数
1、调用系统函数 func welcome (w http.ResponseWriter, r *http.Request) "view/index.html" )
time1 := time.Now()
t.Execute(w, time1)
}
func main () "/" , welcome)
http.ListenAndServe(":9090" , nil )
}
<body >
<pre > 完整时间：{{.}} 年：{{.Year}} 月：{{.Month}} 日：{{.Day}} 格式化时间：{{.Format "2006-01-02 15:04:05"}}</pre >
</body >
2、调用自定义函数 如果希望调用自定义函数，需要借助 html/template 包下的 FuncMap 进行映射。
函数被添加映射后，只能通过函数在 FuncMap 中的 key 调用函数。
func MyFormat (t time.Time) string {
return t.Format("2006-01-02 15:04:05" )
}
func welcome (w http.ResponseWriter, r *http.Request) "mf" : MyFormat}
t := template.New("index.html" ).Funcs(fm)
t, _ = t.ParseFiles("view/index.html" )
time1 := time.Now()
t.Execute(w, time1)
}
func main () "/" , welcome)
http.ListenAndServe(":9090" , nil )
}
<body >
<pre > 完整时间：{{.}} 调用格式化函数：{{mf .}}</pre >
</body >
模版使用 if、range 等
1、二元比较运算函数 eq <=> == ne <=>!= lt < gt > le <= ge >=
2、if 语句 <body > 取出数据{{.}}<br />
{{if .}} 执行了 if {{else}} 执行了 else {{end}}<br /> html 模版信息 </body >
<body > {{$n:=123}} {{if gt $n 456}} 执行 if {{else}} 执行 else {{end}} </body >
3、range 的使用 <body > {{.}}<br /> {{range .}} {{.}}<br /> {{end}} </body >
模版嵌套
在实际项目中常常出现页面复用的情况，例如：整个网站的头部信息和底部信息复用。
可以使用动作 {{template '模版名称'}} 来引用模版。
引用的模版必须在 HTML 中定义这个模版。
{{define "模版名称"}} html {{end}}
{{define "head"}} <!DOCTYPEhtml> <htmllang="en"><head > <metacharset="UTF-8"><title > Title</title > </head > <body > head.html {{.}} </body > </html > {{end}}
{{define "foot"}} <!DOCTYPEhtml> <htmllang="en"><head > <metacharset="UTF-8"><title > Title</title > </head > <body > foot.html {{.}} </body > </html > {{end}}
{{define "layout"}} <!DOCTYPEhtml> <htmllang="en"><head > <metacharset="UTF-8"><title > Title</title > <scripttype="text/javascript"src="/static/js/index.js"></script > </head > <body > {{/*引用 head 模版*/}} {{template "head" "head 的参数"}}<br /> 中间内容<br /> {{template "foot" "head 的参数"}} </body > </html > {{end}}
func welcome (w http.ResponseWriter, r *http.Request) "view/index.gohtml" , "view/head.gohtml" , "view/foot.gohtml" )
if err != nil {
log.Printf("err:%v" , err)
}
t.ExecuteTemplate(w, "layout" , nil )
}
func main () "/" , welcome)
http.ListenAndServe(":9090" , nil )
}
文件上传 文件中 ioutil 包已经弃用，这里使用 io 包和 os 包。
<!DOCTYPEhtml> <htmllang="en"><head > <metacharset="UTF-8"><title > 文件上传</title > </head > <body > <formaction="upload"method="post"enctype="multipart/form-data"> 文件名:<inputtype="text"name="name"/><br /> 文件:<inputtype="file"name="file"/><br /> <inputtype="submit"value="提交"/></form > </body > </html >
<!DOCTYPEhtml> <htmllang="en"><head > <metacharset="UTF-8"><title > 文件上传</title > </head > <body > 文件上传成功 </body > </html >
func welcome (w http.ResponseWriter, r *http.Request) "view/filetest.gohtml" )
t.Execute(w, nil )
}
func upload (w http.ResponseWriter, r *http.Request) "name" )
file, fileHeader, _ := r.FormFile("file" )
b, _ := io.ReadAll(file)
os.WriteFile("D:/" +fileName+fileHeader.Filename[strings.LastIndex(fileHeader.Filename, "." ):], b, 0777 )
t, _ := template.ParseFiles("view/success.gohtml" )
t.Execute(w, nil )
}
func main () "/" , welcome)
http.HandleFunc("/upload" , upload)
http.ListenAndServe(":9090" , nil )
}
文件下载 <!DOCTYPEhtml> <htmllang="en"><head > <metacharset="UTF-8"><title > 文件上传</title > </head > <body > <ahref="download?filename=abc.png">下载</a > </body > </html >
func download (w http.ResponseWriter, r *http.Request) "filename" )
f, err := os.ReadFile("D:/" + filename)
if err != nil {
fmt.Fprintln(w, "文件下载失败" , err)
return
}
h := w.Header()
h.Set("Content-Type" , "application/octet-stream" )
h.Set("Content-Disposition" , "attachment;filename=" +filename)
w.Write(f)
}
相关免费在线工具 Base64 字符串编码/解码 将字符串编码和解码为其 Base64 格式表示形式即可。 在线工具，Base64 字符串编码/解码在线工具，online
Base64 文件转换器 将字符串、文件或图像转换为其 Base64 表示形式。 在线工具，Base64 文件转换器在线工具，online
Markdown转HTML 将 Markdown（GFM）转为 HTML 片段，浏览器内 marked 解析；与 HTML转Markdown 互为补充。 在线工具，Markdown转HTML在线工具，online
HTML转Markdown 将 HTML 片段转为 GitHub Flavored Markdown，支持标题、列表、链接、代码块与表格等；浏览器内处理，可链接预填。 在线工具，HTML转Markdown在线工具，online
JSON 压缩 通过删除不必要的空白来缩小和压缩JSON。 在线工具，JSON 压缩在线工具，online
JSON美化和格式化 将JSON字符串修饰为友好的可读格式。 在线工具，JSON美化和格式化在线工具，online
