strings

strings.ToLower

返回给定字符串,并把所有字符转为小写。

签名
strings.ToLower STRING
返回类型
string
别名
lower

这一页解决什么问题

做不区分大小写的比较,或把一段文本统一成小写外观:判断两个标签是不是同一个、生成 CSS 类名、归一化用户输入。strings.ToLower 把所有字符转成小写(只想动第一个字符请用 strings.FirstLower)。

什么时候用,什么时候别用

该用:

  • 比较之前先归一化:{{ if eq (lower $a) (lower $b) }};
  • 输出需要全小写的标识符、类名。

别用:

  • 生成 URL 的 slug → 用 urls.URLize:它会同时处理空格、标点与百分号编码,lower 不处理这些;
  • 只把首字符转小写 → 用 strings.FirstLower;
  • 想要标题式大小写 → 用 strings.Title。

用法

go-html-template
{{ lower "BatMan" }} → batman

完整示例(实测)

layouts/_partials/normalize.htmlgo-html-template
{{ lower "BatMan" }}

Hugo 0.167.0 实测输出:

batman

你应当看到什么:整串都被转换,B 和 M 都变成小写。中文不受影响(实测 lower "汉字ABC" → 汉字abc)。

返回值边界(实测)

测量条件:Hugo 0.167.0 extended,单语言站点(locale = 'zh-CN'),Windows。

输入 结果 是否报错
"BatMan" batman 否
"汉字ABC" 汉字abc(非拉丁字符原样保留) 否
""(空字符串) "" 否
已经是小写的字符串 原样返回 否
返回类型 string,永远不是 nil 否

常见坑

类别 症状 真因 怎么修
没报错但结果不对 大小写比较仍然失败 只归一化了其中一边(或用了 strings.Contains 这类本身就区分大小写的函数) 两边都先 lower 再比较;包含判断也要对两边同时处理
没报错但结果不对 slug 里出现空格或百分号 lower 只处理大小写,不处理空格与特殊字符 生成 slug 用 urls.URLize
没报错但结果不对 只想要第一个字母小写 本函数会把整串都变小写 改用 strings.FirstLower

更多排查入口见故障排查。