go博客系统应优先用net/http、os.readdir和goldmark实现静态内容服务：三行路由处理、一级目录读取、标准markdown渲染，再通过模板函数简化逻辑，避免过早抽象。
Go 语言本身不提供“开箱即用的博客系统”，写一个可用的博客系统，核心不是堆功能，而是明确边界：静态内容优先、避免过早抽象、用标准库扛住大部分需求。
用 net/http 而不是框架起步
很多新手一上来就选 gin 或 echo，结果卡在中间件链、路由分组、模板继承嵌套里。实际博客最重的逻辑是“读文件 → 渲染 HTML → 返回响应”，net/http 三行就能跑通：
http.HandleFunc("/post/", func(w http.ResponseWriter, r *http.Request) {
slug := strings.TrimPrefix(r.URL.Path, "/post/")
post, err := loadPostBySlug(slug)
if err != nil { http.Error(w, "not found", 404); return }
renderTemplate(w, "post.html", post)
})
好处是：没有隐式调用、没有上下文穿透、错误路径清晰。等路由超 20 条、模板逻辑变复杂时，再考虑封装或换框架也不迟。
os.ReadDir 替代 filepath.Walk 列出文章
博客文章通常按文件组织（如 content/post/hello-world.md），常见错误是用 filepath.Walk 递归扫描整个目录——它会进 .git、node_modules，还可能因权限失败中断遍历。
更稳的做法是只读一级 content/post/ 目录，用 os.ReadDir（Go 1.16+）：
- 返回
fs.DirEntry列表，不触发Stat调用，速度快 - 跳过隐藏文件只需判断
entry.Name()[0] == '.' - 过滤
.md文件后，再对每个文件调用os.ReadFile解析 front matter
如果还要支持子目录分类（如 post/tech/go.md），就限定递归深度为 1，别无脑 Walk。
Markdown 渲染别硬刚 blackfriday，用 goldmark
blackfriday 已归档，文档少、扩展难；goldmark 是 Hugo 官方渲染器，API 明确、扩展点清晰。关键配置就两处：
- 启用 GitHub 风格表格：
goldmark.WithExtensions(extension.GFM) - 自定义代码块语法高亮：传入
extension.WithCodeBlockHTMLRenderer+ 你自己的RenderCodeBlock函数
别试图自己解析 Markdown AST——95% 的博客只需要标题、段落、代码块、链接。用 goldmark 的 Parse + Renderer 两步走，稳定且易调试。
模板里别传太多数据，用 template.FuncMap 抽离逻辑
常见反模式：把所有文章元信息塞进 map[string]interface{} 传给模板，结果模板里满屏 {{if .Meta.Author}}{{.Meta.Author}}{{else}}Anonymous{{end}}。
更好的方式是注册模板函数：
funcMap := template.FuncMap{
"authorName": func(m map[string]string) string {
if name := m["author"]; name != "" { return name }
return "Anonymous"
},
}
这样模板里只写 {{authorName .Meta}}。函数可复用、可测试、模板更干净。注意：函数不能有副作用，别在里头读文件或发 HTTP 请求。
真正卡住进度的往往不是“怎么实现 RSS”或“怎么加评论”，而是路径拼错导致 404、模板变量名大小写不一致、Markdown 解析时 panic 没 recover。先让单篇文章能从文件显示到浏览器，再一关一关加功能。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
