Golang搭建简单博客系统教程

本文手把手教你用 Go 原生 net/http 从零构建一个安全、可维护、易扩展的轻量博客系统，强调“初期不盲目上框架”，通过显式 ServeMux 管理路由、JSON 文件存储替代数据库、blackfriday/v2 安全渲染 Markdown（配合白名单过滤防 XSS）、validator 统一结构化校验，以及严格分层——让 handler 只负责请求解析与响应，业务逻辑、文件操作、数据持久化全部下沉至独立 service 层，从而在功能简单时保持清爽，在未来需添加分类、标签、草稿等特性时仍能低成本演进，真正实现“小起步、大格局”的工程实践。

用 net/http 搭建基础路由，别急着上框架

Go 自带的 net/http 足够支撑初期博客的 CRUD，加框架反而增加理解成本和部署复杂度。重点是把请求路径、方法、数据绑定逻辑理清楚。

常见错误：直接在 http.HandleFunc 里写业务逻辑，导致函数臃肿、无法测试、难以复用。

• 每个路由 handler 应只做三件事：解析请求（r.URL.Query() 或 json.NewDecoder(r.Body)）、调用 service 层函数、写响应（json.NewEncoder(w).Encode()）
• 避免在 handler 中操作文件或数据库连接——这些应封装进独立函数，便于单元测试和替换
• 使用 http.ServeMux 显式注册路由，比默认 http.DefaultServeMux 更可控，也方便后续加中间件（如日志、认证）

文章存储用 JSON 文件就够了，先别碰数据库

早期博客内容少、并发低、无事务需求，用 os.WriteFile 写入结构化 JSON 到 ./data/posts/ 目录，比 SQLite 或 PostgreSQL 启动快、备份简单、调试直观。

容易踩的坑：多个请求同时写同一个文件导致数据丢失。

• 给每篇文章生成唯一 ID（推荐 uuid.NewString()），文件名即 ID，避免中文或空格命名
• 读取时用 os.ReadFile + json.Unmarshal；写入前先 os.MkdirAll("./data/posts", 0755)
• 不要用 os.OpenFile(..., os.O_APPEND) 追加——JSON 不支持追加，必须整文件重写
• 若需原子写入，可先写到临时文件（tmp := path.Join(dir, id+".tmp")），再 os.Rename

解析 Markdown 用 blackfriday/v2，但注意 XSS 风险

blackfriday/v2 是目前最稳定的 Go Markdown 解析器，支持自定义 renderer，适合博客正文渲染。

关键问题：用户提交的 Markdown 可能含恶意 HTML（如 ），直接渲染会引发 XSS。

• 务必启用安全选项：html.WithUnsafe(false)（默认就是 false，但显式写出更稳妥）
• 若需保留部分 HTML（如 ），应配合 bluemonday 做白名单过滤，而不是关掉 WithUnsafe
• 标题自动锚点、表格样式、代码块高亮需自定义 html.Renderer，不要依赖默认输出
• 示例中不要用 blackfriday.Run([]byte(md)) —— 它已弃用，改用 markdown.ToHTML（v2 API）

发布流程卡在表单验证？用结构体标签 + validator 库

手动检查 title != ""、len(content) > 10 很容易漏，且分散在各 handler 中。统一用 go-playground/validator 结合 struct tag 约束。

典型场景：新建文章时前端传了空 title 或超长 slug。

• 定义结构体时用 validate:"required,min=1,max=100" 等 tag，字段名保持小写（Title string `json:"title" validate:"required"`）
• 验证失败时，用 err.(validator.ValidationErrors) 提取具体字段和规则，返回 JSON 错误（如 {"field":"title","error":"required"}）
• slug 自动生成逻辑放 service 层，不要依赖前端传入；可用 strings.ToLower(strings.ReplaceAll(title, " ", "-")) 简单处理
• 注意：validator 默认不校验嵌套结构体，如有 Metadata 字段需加 validate:"dive"

type Post struct {
	ID       string `json:"id"`
	Title    string `json:"title" validate:"required,min=1,max=100"`
	Slug     string `json:"slug" validate:"required,alphanumdash"`
	Content  string `json:"content" validate:"required,min=10"`
	CreatedAt time.Time `json:"created_at"`
}

func (p *Post) Validate() error {
	return validator.New().Struct(p)
}

真正难的不是写完发布功能，而是当某天想加分类、标签、草稿箱时，发现当初没把数据模型和 HTTP 层解耦——那时再重构，比从头写还费劲。

本篇关于《Golang搭建简单博客系统教程》的介绍就到此结束啦，但是学无止境，想要了解学习更多关于Golang的相关知识，请关注golang学习网公众号！