Go fmt 输出出现 %!s 怎么改格式化动词

Go fmt 输出出现 %!s(int=17)，表示本次 %s 遇到不适合按字符串格式化的 int。若这个值表示数量，应把对应动词改为 %d；若只是临时观察值，可选 %v。不要删除报错标记后继续使用原格式串，也不要先把所有参数强行转换成字符串。

官方地址：https://go.dev/。本文只讨论 fmt 动词、参数类型与诊断片段；代码与预期按接口规则说明，不是实测截图或终端记录。

先读懂 %!s 后面的诊断

%!s 不是一种正常的格式化动词，而是格式化过程中产生的诊断标记。s 表示相关动词，括号里的内容帮助判断失败原因。若只看到日志被截断后的 %!s，先拿到完整片段，再决定改动哪里。

对于普通 int 参数，%s 不表达十进制数量，所以会出现类型和值的提示。但 %!s(MISSING) 表示缺少参数，不是参数类型错误；%!(EXTRA int=17) 则提示有多余参数。修复方向不同：前者补齐或删除占位符，后者让参数与格式串一致。

在 %s、%d 和 %v 之间按语义选择

选择动词应看“要怎样展示”，而不是看“怎样让错误消失”。字符串用 %s 输出文本；普通整数数量用 %d；布尔状态用 %t；浮点数需要固定小数时用 %.2f 之类的格式；%v 用于默认表示，%T 用于查看类型，不是值本身的替代格式。

例如 ratio 为浮点比例，%v 的默认表示与 %.2f 的固定两位小数要求并不相同。把所有字段都换成 %v 可能消除类型不匹配提示，却丢失十六进制、引号、精度等展示约束。业务日志若需要稳定字段表示，应显式选择格式。

先看参数类型，再看参数顺序

参数保存在 any 或接口变量中时，实际格式化仍涉及其内部具体值。排查普通业务值，可以在对应位置先用 %T 查看类型，再逐一对照格式串。不要因为变量名叫 text 就认定它一定是 string，也不要把所有报错归因于 Sprintf 或日志框架。

默认情况下，动词按顺序消耗参数；插入或删除字段以后，后续位置可能全部错位。%*s 还额外消耗一个整数宽度参数；如果宽度给成浮点数，会得到 BADWIDTH。带显式参数索引的格式串另有索引规则，不宜只按占位符数量粗略计数。

另外，Println 不解释 %s 这样的格式串。它适合按默认表示打印多个值并换行；Printf、Sprintf、Fprintf 才按格式串处理。若日志里原样出现 %s 而没有 %! 诊断，也应检查是否调用了不带 f 的打印方法。

修复一个混合字段的输出语句

设想任务日志包含名称、数量、布尔状态与比例。若复制一串 %s 填入所有字段，就会把不同类型误当成同一种文本。下面保留每个字段的展示含义，参数顺序与格式串一一对应：

package main

import "fmt"

func main() {
    name := "归档任务"
    count := 17
    ready := true
    ratio := 0.375

    // 先看动态类型，不把未知参数一律当成字符串。
    fmt.Printf("类型：%T %T %T %T\n", name, count, ready, ratio)
    // 各字段分别表达文本、十进制数量、布尔值及固定小数。
    fmt.Printf("任务=%s 数量=%d 就绪=%t 比例=%.2f\n",
        name, count, ready, ratio)
    // 调试时可观察默认表示；这不是固定小数输出的替代方案。
    fmt.Printf("默认比例=%v\n", ratio)
    // 单个百分号在格式串中用两个百分号表示，不消耗额外参数。
    fmt.Printf("完成度=%.1f%%\n", ratio*100)
}

按这些值与格式规则，数量应显示为 17，布尔值为 true，固定两位小数的比例为 0.38；百分比显示为 37.5%。这些是示例预期，不是本机执行证明。%% 输出单个百分号，不额外消耗参数，所以最后一条调用只需要 ratio*100 这个参数。

如果日志来自另一层封装，还要核对该层是否原样转发格式串与参数。例如包装函数收到可变参数后遗漏展开，可能把一整个切片当成单个参数传给 fmt，导致数量和类型都不符合预期。这时仅替换动词会掩盖调用方式错误。

这些情况不是换成 %v 就能解决

第一，不要用 string(count) 获取十进制数字文本。整数转 string 表达的是 Unicode 码点对应的字符，不等于数值的十进制表示。只是输出数量时直接用 %d；确实需要存储数字字符串时，再选择明确的数值转字符串方式。

第二，%s 不仅限于内建 string。字节切片支持字符串式格式化，某些实现 String 或 Error 方法的值也有特殊处理；实现 fmt.Formatter 的类型还能控制动词语义。因此不能写成“所有非 string 参数都禁止 %s”。本文的直接改法针对不带这些特殊方法的普通值。

第三，%v 也可能调用自定义方法。若完整片段是 %!s(PANIC=...)，应继续检查 String、Error 或自定义格式化逻辑，而非把它当普通 int 类型不匹配。诊断标记只是入口，括号内容才是区别这些情况的关键。

第四，动态文字如果本来就要原样输出，不应把它放进格式串位置。它可能包含百分号或看起来像动词的片段；把文字当值传入更符合意图：

// 不需要格式解释时，把动态文本作为值传入，不把它当格式串。
message := "进度占位符 %s"
fmt.Println(message)
// 需要格式化时，固定格式串与参数分离。
fmt.Printf("消息=%s\n", message)

把选择规则收成一张速查表

fmt 返回的 error 能捕获这种格式错误吗？

不要依赖这一点。格式问题通常被写进生成文本；Printf 或 Fprintf 返回的错误主要用于报告写入失败。Sprintf 只返回字符串，没有独立的 error 返回值。

%v 能作为长期修复吗？

可以用于本来就要默认表示的字段，但不能替代十进制、精度或引用方式等明确要求。先确定展示意图再选，而不是只看日志中是否还有 %!。

为什么调整一个字段后其他字段也坏了？

先检查参数顺序和额外消耗宽度的星号，再看有无显式索引。一个位置错位可能让多个后续参数被错误动词处理。

参考：fmt 格式错误与动词文档。排查时保留完整诊断，识别参数实际类型，再按展示语义修改对应位置，比批量替换 %s 更可靠。