fmt

fmt.Print

返回给定参数默认的字符串表示。

签名
fmt.Print INPUT
返回类型
string
别名
print

这一页解决什么问题

把若干值拼成一段文本,或者把一个结构(切片、映射、数字、布尔)转成可读的字符串。print 就是 Go fmt.Print 的模板版本:它按默认格式输出每个参数,参数之间不加任何分隔。调试模板时最常用它把值直接打到产物里看一眼。

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

该用:

  • 简单拼接,不需要格式控制;
  • 调试:把一个类型不确定的值转成字符串看一眼。

别用:

  • 需要小数位、补零、加引号等格式控制 → 用 fmt.Printf;
  • 需要参数之间带空格、末尾带换行 → 用 fmt.Println;
  • 想输出模板片段当 HTML → 需要 safe.HTML,否则标签会被转义;
  • 想写进构建日志(而不是产物)→ 用 fmt.Warnf / fmt.Errorf。

用法

go-html-template
{{ print "foo" }} → foo
{{ print "foo" "bar" }} → foobar
{{ print (slice 1 2 3) }} → [1 2 3]

完整示例(实测)

layouts/_partials/debug.htmlgo-html-template
[{{ print "foo" }}]|[{{ print "foo" "bar" }}]|[{{ print (slice 1 2 3) }}]|[{{ print nil }}]

Hugo 0.167.0 实测输出:

[foo]|[foobar]|[[1 2 3]]|[<nil>]

你应当看到什么:两个字符串被直接相连成 foobar(没有空格);切片输出成 [1 2 3],所以外层方括号里套了内层方括号;nil 输出成 <nil>——这正是调试时想看到的信息。

返回值边界(实测)

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

输入 结果 是否报错
"foo" "bar" foobar(无分隔符) 否
(slice 1 2 3) [1 2 3] 否
42 42 否
true true 否
nil <nil> 否
返回类型 string,永远不是 nil 否

常见坑

类别 症状 真因 怎么修
没报错但结果不对 print "a" "b" 得到 ab,不是 a b 本函数不在参数之间插空格 需要空格用 fmt.Println 或自己写 " "
没报错但结果不对 输出的 HTML 标签变成了可见文本 字符串按 HTML 规则转义 明确要当 HTML 用时套 safe.HTML
没报错但结果不对 数字精度不对 print 用默认格式,不接受精度控制 用 fmt.Printf 配 %.2f 之类

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