Beego中需手动集成静态页生成：通过StaticGenerator类复用模板引擎，用time.Ticker定时调用render并写入文件，注意路径处理、错误恢复、权限设置及上线前完整性校验。
Beego 中如何触发静态页面生成
Beego 本身不提供内置的静态站点生成器（SSG），所以不能像 Hugo 那样直接 bee run -static。静态页生成必须手动集成：在应用启动后、或通过定时任务调用渲染逻辑，把 Controller.Render() 的输出捕获为 HTML 字符串，再写入文件系统。
关键点在于绕过 HTTP 响应流程，直接复用 Beego 的模板引擎和上下文数据。推荐做法是新建一个 StaticGenerator 工具类，用 beego.BConfig.WebConfig.ViewsPath 定位模板，用 beego.AddTemplate 确保模板已加载，再调用 template.Execute() 手动执行渲染。
- 不要在
Get()方法里直接os.WriteFile()—— 这会阻塞请求，且无法复用模板缓存 - 避免使用
context.ResponseWriter捕获输出，Beego v2+ 的context不暴露底层http.ResponseWriter的写入缓冲区 - 正确路径拼接：模板名如
"article.tpl"，对应磁盘路径应为beego.BConfig.WebConfig.ViewsPath + "/article.tpl"
用 time.Ticker 实现可靠定时生成
Beego 应用启动后，可在 func main() 或 beego.BootStrap() 阶段启动独立 goroutine，用 time.Ticker 触发生成逻辑。不建议用 time.AfterFunc 递归调用——一旦某次生成 panic，后续调度就彻底中断。
示例节选：
go func() {
ticker := time.NewTicker(1 * time.Hour)
defer ticker.Stop()
for range ticker.C {
if err := GenerateStaticPages(); err != nil {
beego.Error("static gen failed:", err)
}
}
}()- 务必加
defer ticker.Stop()，否则进程退出时 goroutine 泄漏 - 生成函数内部需做 recover，防止 panic 导致整个 ticker 停摆
- 若生成耗时可能超过间隔（比如全站重建要 5 分钟），应改用
time.After+ 循环 sleep，避免并发重入
打包成 tar.gz 时注意路径与权限
生成完 HTML 文件后，打包目标通常是 ./static_site/ 目录。用 archive/tar + gzip 打包时，常见错误是文件头里的 Header.Name 含绝对路径（如 /home/user/app/static_site/index.html），解压时会覆盖系统路径。
正确做法是统一以相对路径写入：strings.TrimPrefix(filePath, baseDir)，其中 baseDir 是打包根目录的绝对路径。
- 忽略
.git、.DS_Store等非内容文件，避免污染包体积 - 设置
Header.Mode = 0644（而非默认 0），否则 Linux 下解压后可能不可读 - 打包前建议
os.Chmod(outputTar, 0644)，Windows 上默认创建的文件可能无读权限
上线前必须校验生成结果的完整性
定时生成 + 打包流程一旦后台运行，很容易“以为成功实则失败”：模板语法错误只在首次渲染时报错；路径变更后 os.Stat() 检查缺失却没 fail；gzip 写入中途磁盘满导致包损坏但无报错。
上线前至少做三件事：
- 检查输出目录下关键文件是否存在：
os.Stat("static_site/index.html") - 用
tar -tzf static_site.tar.gz | head -n 5快速验证包可读性（Go 中可用tar.NewReader(gzipReader)尝试读取前几个 header） - 对生成的 HTML 做简单断言，例如
bytes.Contains(htmlBytes, []byte("<title>"))，确认模板未被空渲染
最易被忽略的是：生成逻辑依赖数据库查询，但定时任务启动早于 DB 连接就绪。务必在 GenerateStaticPages() 开头加 if !orm.GetDB().Ping() { return errors.New("db not ready") } 类似防护。
