Buffalo模板无内置substring函数，需自定义注册substr函数处理UTF-8符文、越界防护及空值判断，调用时须严格按s/start/length顺序传参。
Buffalo模板里没有内置的substring函数
Buffalo的html/template底层沿用Go标准库，不提供类似LEFT或MID那样的字符串截取函数。你写{{ substring .Title 0 20 }}会直接报错：function "substring" not defined。这不是配置问题，是模板引擎本身没实现这个功能。
必须用自定义模板函数注册substr
要在Buffalo中安全截取文本，得自己写一个substr函数并注册进模板上下文。它需要处理越界、负索引、UTF-8字符边界等真实场景问题：
- Go的
string是字节序列，直接s[0:10]可能切在中文字符中间，导致乱码 - Buffalo默认不校验索引合法性，越界会panic，必须手动防御
- 推荐用
utf8.RuneCountInString算符文数，再用strings.Builder拼接前N个rune
示例注册代码（放在app.go的App()函数内）：
app.RegisterTemplateFunc("substr", func(s string, start, length int) string {
if s == "" || length <= 0 {
return ""
}
runes := []rune(s)
max := len(runes)
if start < 0 {
start = max + start
if start < 0 {
start = 0
}
}
if start >= max {
return ""
}
end := start + length
if end > max {
end = max
}
return string(runes[start:end])
})
模板中调用substr要严格按顺序传参
Buffalo模板函数不支持命名参数，顺序错一位就全错。常见误用：
Buffalo框架 1.0.1
下载
Buffalo框架 1.0.1 版本源码包下载，适合需要错误处理改进、依赖更新、render.Download 注释和 request logger 调整的 v1 项目。
-
{{ substr .Content 50 0 }}→ 截0个字符，返回空串（不是从第50位截到末尾） -
{{ substr .Title -10 20 }}→ 负起始位置，表示从倒数第10个字符开始取20个 - 想“截取前50字符，超长加省略号”得组合写：
{{ if gt (len .Desc) 50 }}{{ substr .Desc 0 47 }}...{{ else }}{{ .Desc }}{{ end }}
注意：len函数对string返回的是符文数（不是字节数），和substr的逻辑一致，这点比原生Go模板更友好。
生产环境必须加长度限制和空值防护
用户输入的字段（比如.User.Bio）可能为空、超长、含控制字符。直接{{ substr .Bio 0 100 }}在渲染时崩溃的风险很高：
- 永远先用
{{ if .Bio }}判断非空，空值传给substr会panic - 前端展示摘要建议硬性限制在200符文以内，避免布局溢出
- 如果字段来自不可信来源（如评论），截取后最好再过一遍
strings.TrimSpace，但这个得在Go代码层做，模板里没法链式调用
最易被忽略的一点：Buffalo的模板函数注册是全局的，一旦在app.RegisterTemplateFunc里定义了substr，所有模板都能用——包括邮件模板、管理后台模板，它们可能对性能更敏感，别在substr里偷偷加日志或网络请求。
