strings.ContainsNonSpace
报告给定字符串是否包含 Unicode 定义的非空白字符。
这一页解决什么问题
判断一个参数「是不是空的」时,eq $v "" 只挡住了真正长度为 0 的字符串。前置元数据里写成 " "、"\n" 的值一样没有内容,却会通过 eq 检查,最后在页面上留下一个空标题或空按钮。strings.ContainsNonSpace 问的是「里面有没有任何非空白字符」,正好用来判断「这个值到底有没有内容」。
什么时候用,什么时候别用
该用:
- 前置元数据、
site.Params里的可选文本字段,判断「有内容才渲染」; - 想同时挡住空格、制表符、换行、以及 Unicode 空格分隔符(含不换行空格 U+00A0)。
别用:
- 只想判断字符串是否恰好为空串 →
{{ if eq $v "" }}更直接; - 想把首尾空白删掉再判断 → 用
strings.TrimSpace; - 想数有效字符个数 → 用
strings.CountRunes; - 想判断「包含某个子串」→ 用
strings.Contains。
用法
空白字符包括 \t、\n、\v、\f、\r,以及 Unicode 空格分隔符(Unicode Space Separator) 类别中的字符。
go-html-template
{{ strings.ContainsNonSpace "\n" }} → false
{{ strings.ContainsNonSpace " " }} → false
{{ strings.ContainsNonSpace "\n abc" }} → true完整示例(实测)
layouts/_partials/has-content.htmlgo-html-template
{{ $v := "\n " }}
空白参数:{{ strings.ContainsNonSpace $v }},有内容:{{ strings.ContainsNonSpace "有内容" }}Hugo 0.167.0 实测输出:
空白参数:false,有内容:true你应当看到什么:$v 里只有换行和空格,所以是 false;换成真正的中文文本就是 true。注意这个判断看的是「有没有非空白字符」,不是「长度是否大于 0」。
返回值边界(实测)
测量条件:Hugo 0.167.0 extended,单语言站点(locale = 'zh-CN'),Windows。
| 输入 | 结果 | 是否报错 |
|---|---|---|
""(空字符串) |
false |
否 |
" "、"\n"、"\t" |
false |
否 |
"\u00a0"(不换行空格 U+00A0) |
false——它属于 Unicode 空格分隔符 |
否 |
"\n abc"、"有内容" |
true |
否 |
42(数字) |
true——先转成字符串 "42",其中都是非空白字符 |
否 |
| 返回类型 | bool,永远不会是 nil |
否 |
常见坑
| 类别 | 症状 | 真因 | 怎么修 |
|---|---|---|---|
| 没报错但结果不对 | 用 eq $v "" 判断后仍渲染出空标题 |
" " 不等于 "" |
改用本函数(实测 " " 返回 false) |
| 没报错但结果不对 | 明明只想判空,数字参数却返回 true |
非字符串参数会先转成字符串,42 → "42" |
先确认字段类型,必要时用 printf "%v" 显式转换后再判断 |
更多排查入口见故障排查。