buffalo 不适用于轻量静态文件渲染场景，因其是全栈框架、依赖繁重、无法剥离；推荐用 go 原生 embed + html/template + http.fileserver + goldmark 实现安全、极简、可嵌入的渲染服务。
为什么 Buffalo 无法干净地作为“静态文件渲染端”
Buffalo 的 app.ServeFiles() 和 app.Use(plugins.Static()) 默认绑定在全局中间件链上，静态路径与模板渲染共用同一路由树，无法做到「仅渲染、不执行业务逻辑」；它的模板引擎（Plush）不支持 html/template 的 template.HTML 类型校验，也缺乏对 embed.FS 的原生集成；更关键的是，Buffalo 二进制必须加载 actions/app.go 入口，无法编译为纯渲染器——你没法把它塞进一个只做 POST /render 返回 HTML 的 sidecar 容器里。
用 embed + html/template 替代 Buffalo 渲染层
Go 1.16+ 原生 embed 是唯一推荐方案：模板编译进二进制，无运行时路径风险，零依赖，适合微服务嵌入。
- 把所有
.html文件放在templates/目录下，确保文件名合法（无空格、无特殊符号） - 在代码中声明：
//go:embed templates/*.html，类型为embed.FS - 解析时用
template.Must(template.New("").ParseFS(templatesFS, "templates/*.html"))，不是ParseFiles - 传入数据前，确保结构体字段首字母大写（
Title string，不是title string），且避免 nil 指针直接访问
静态文件服务必须用 http.FileServer + 安全包装
别用 http.ServeFile 或自定义 handler 模拟静态服务——它不处理子路径、不推断 MIME、不返回 404，也不防遍历。
- 始终用绝对路径构造
http.Dir：dir, _ := filepath.Abs("./public")，否则跨目录运行必 404 - 挂载时严格配对
http.StripPrefix：http.Handle("/static/", http.StripPrefix("/static/", http.FileServer(http.Dir(dir)))) - 生产环境禁用
http.Dir直接暴露——改用http.FS(os.DirFS(dir))（Go 1.16+），它默认拒绝../越界 - 若需 SPA fallback（如 React Router），单独加一个兜底路由：
if strings.HasSuffix(r.URL.Path, "/") || r.URL.Path == "/"，再查index.html
Markdown 渲染必须在 Go 层完成，不能甩给模板
标准 html/template 不解析 Markdown。常见错误是模板里写 {{.Content | md}} 却没注册函数，或每次调用都重新 parse——这在高并发下会吃光 CPU。
- 用
goldmark在数据准备阶段一次性转成template.HTML字符串 - 自定义函数注册时，返回类型必须是
template.HTML，否则会被二次转义 - 不要在模板里传原始
.RawContent然后现场转换——提前做好，传.HTMLContent - 生成静态站点时，注意
os.Create("posts/a/b/index.html")会因父目录不存在失败，得先os.MkdirAll(path.Dir(...), 0755)
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
