Beego模板404主因是路径/后缀未同步配置：需在beego.Run()前用SetViewPath设路径、AddTemplateExt加后缀；函数须提前注册且签名合规；时间解析、字符串截取等须防panic与乱码。
模板路径和后缀怎么设才不会 404
Beego 默认在 view 目录下找模板，文件名必须匹配控制器方法名 + .tpl 或 .html（如 MainController.Get() → view/main/get.tpl）。如果改过目录或后缀，没同步配置就会报找不到模板。
- 用
beego.SetViewPath("your_view_dir")指定新路径，必须在beego.Run()前调用 - 添加非默认后缀：调用
beego.AddTemplateExt(".htm")，否则.htm文件会被忽略 - 配置文件里设
viewpath = "myviews"也生效，但代码中调用SetViewPath优先级更高 - 检查
c.TplName是否写错大小写或路径，比如"index.html"实际文件是Index.html，在 Linux 下就是 404
自定义函数必须在 beego.Run() 前注册
这是最常踩的坑：把 beego.AddFuncMap 放在 main() 函数里、甚至放在某个 controller 的 Get() 方法里，函数永远进不了模板。Beego 只在启动初始化阶段扫描一次函数映射表。
- 推荐统一在
utils包的Init()函数里集中注册，然后在main.go的init()函数中调用它 - 函数签名必须是
func(string) string或func(string) (string, error)等单入参、单出参形式；多参数不支持 - 模板中调用时注意语法：管道式
{{.TimeStr | FormatTimeStr}}和直接调用{{FormatTimeStr .TimeStr}}都可以，但后者不能链式传参 - 函数名在模板里区分大小写，
formatTimeStr和FormatTimeStr是两个不同函数
时间格式化函数容易 panic 的原因
time.Parse 失败会返回 err != nil，如果没判空就直接调 formatTime.Unix()，模板渲染时 panic，整个页面白屏，日志里只有一行 reflect: Call of nil function —— 这个错误信息完全不指向问题根源。
- 务必检查
err == nil再使用解析后的time.Time值 - 输入字符串为空、格式不匹配（如传了
"2006/01/02"却用"2006-01-02 15:04:05"解析）都会导致失败 - 建议加 fallback：解析失败时返回原始字符串或默认值，而不是空串或 panic
- RFC1123 格式末尾带时区缩写（如
"Mon, 02 Jan 2006 15:04:05 MST"），截掉最后 3 位（str[0:len(str)-3]）虽能去 MST，但遇到 GMT、UTC 等缩写会出错；更稳妥的是用formatTime.Format("Mon, 02 Jan 2006 15:04:05")
字符串截取函数要注意中文乱码
Go 字符串底层是字节序列，str[0:n] 按字节切，如果 n 正好卡在 UTF-8 中文字符中间，结果就是非法 UTF-8，浏览器渲染时显示 或空白。
- 别用
str[0:num]，改用utf8string.Substr(str, 0, num)（需引入"golang.org/x/text/unicode/norm"）或手动遍历 rune - 简单方案：先转成
[]rune，再切片，最后转回 string：rs := []rune(str); return string(rs[0:min(num, len(rs))]) - 如果只是补省略号，记得判断长度时也按 rune 数算：
if utf8.RuneCountInString(str) > num - 模板里传参类型要一致：函数声明是
func(str string, num int) string，就不能传{{SubAndReplace .Title 10.5}}，int 类型不匹配会静默失败
