首先构建HTML表单用于提交姓名和留言,通过POST方法发送数据至/post路由;接着在Go后端使用net/http包注册路由并处理请求,调用ParseForm解析表单,利用FormValue获取字段值并进行非空校验;然后设计Message结构体,采用内存切片存储消息,每次提交生成带时间戳的Message实例并追加到全局切片;最后实现GET请求处理函数,使用text/template模板渲染页面,遍历messages切片展示所有留言内容,完成基础留言板功能。

构建一个留言板网站是学习 Golang Web 开发的典型实践项目。它涉及表单提交、数据验证、后端处理和持久化存储等核心知识点。下面将一步步讲解如何使用原生 Go 构建这样一个系统,不依赖框架,便于理解底层逻辑。
表单设计与前端交互
留言板最基本的功能是让用户输入姓名和留言内容并提交。我们可以用简单的 HTML 表单实现:
这个表单通过 POST 方法向 /post 路由提交数据。在 Go 后端中,我们需要注册该路由并解析请求体中的表单字段。
处理表单提交
在 Go 中使用 net/http 包接收并解析表单数据。关键步骤包括:启用表单解析、读取字段值、做基本校验。
立即学习“go语言免费学习笔记(深入)”;
示例代码:
func postHandler(w http.ResponseWriter, r *http.Request) {
if r.Method != "POST" {
http.Error(w, "只允许 POST 请求", http.StatusMethodNotAllowed)
return
}
// 解析表单(自动调用 ParseForm 或 ParseMultipartForm)
err := r.ParseForm()
if err != nil {
http.Error(w, "无法解析表单", http.StatusBadRequest)
return
}
name := r.FormValue("name")
message := r.FormValue("message")
if name == "" || message == "" {
http.Error(w, "姓名和留言不能为空", http.StatusBadRequest)
return
}
// 存储到内存或数据库
saveMessage(name, message)
// 提交成功后跳转回首页
http.Redirect(w, r, "/", http.StatusSeeOther)
}
r.FormValue() 自动从 POST 正文或 URL 查询参数中提取对应字段,适合简单场景。注意要先调用 ParseForm(),否则拿不到数据。
数据存储方案选择
对于小型留言板,有几种常见存储方式:
- 内存存储:使用 slice 或 map 保存消息,重启即丢失,适合测试
- 文件存储:将每条留言追加写入 JSON 或 CSV 文件,轻量且无需额外服务
- SQLite 数据库:嵌入式数据库,结构清晰,支持查询,推荐用于生产级小应用
以内存存储为例:
type Message struct {
Name string
Message string
Timestamp time.Time
}
var messages []Message
func saveMessage(name, msg string) {
m := Message{
Name: name,
Message: msg,
Timestamp: time.Now(),
}
messages = append(messages, m)
}
若改用 SQLite,可用 database/sql 包配合驱动(如 _ "github.com/mattn/go-sqlite3")执行 INSERT 语句。
展示留言列表
用户访问首页时,应显示所有已提交的留言。需要一个 GET 处理函数读取数据并渲染模板。
示例:
func indexHandler(w http.ResponseWriter, r *http.Request) {
tmpl := `
留言板
{{.Name}} ({{.Timestamp.Format "2006-01-02 15:04"}}): {{.Message}}
{{end}}这里使用 text/template 渲染动态内容,{{range .}} 遍历传入的数据切片。
基本上就这些。从表单接收到数据存储再到页面展示,整个流程清晰明了。随着需求增长,可逐步加入防 XSS、分页、用户认证等功能。Golang 的简洁性和强类型特性让这类 Web 应用易于维护和扩展。










