Go fmt.Sscanf 怎样按格式读取固定字段

解析一段结构稳定的内部文本时，fmt.Sscanf 的关键不是“把字符串拆开”，而是把格式模板、目标变量、扫描数量和错误边界同时管理起来。它适合读取类似 "id=42 name=alice" 这样的受控输入；如果输入格式开放、字段可选很多，应该换成专用解析器。

官方地址：https://pkg.go.dev/fmt#Sscanf

最稳妥的判断方式是：目标参数传指针，先看返回的扫描数量是否达到预期，再处理 error。数量不足时，即使已有字段被写入，也不能把整条记录当作完整。

先把输入、格式和扫描结果分开

fmt.Sscanf 接收待解析字符串、格式模板和一组目标参数。目标参数必须是可写入的指针；返回值中的 n 表示成功写入了多少个目标，err 说明为什么没有继续完成。不要只把它写成一行并忽略返回值。

package main

import (
    "errors"
    "fmt"
)

func parseRecord(text string) (int, string, error) {
    var id int
    var name string

    // 目标参数传指针，fmt.Sscanf 才能把字段写回变量。
    n, err := fmt.Sscanf(text, "id=%d name=%s", &id, &name)
    // 数量不足表示记录不完整；不要只依赖 err 是否为 nil。
    if n != 2 {
        if err == nil {
            err = errors.New("字段数量不足")
        }
        return 0, "", fmt.Errorf("解析记录失败：已读取 %d 个字段：%w", n, err)
    }
    return id, name, nil
}

这个例子把“完整记录”的条件明确成 n == 2。如果输入只包含 id=42，第一个变量可能已经被写入，但调用方仍应收到失败结果。

用空白和格式动词描述固定字段

普通扫描动词会按 fmt 的扫描规则处理空白；格式中的空白通常对应输入中的一段空白，而不是要求只能出现一个空格。换行是否能被当作普通空白，还取决于使用的扫描函数和格式位置。需要读取下一个原始字符时，%c 是一个特殊边界：它不会先跳过空白。

package main

import "fmt"

func readFields(text string) (string, int, byte, error) {
    var label string
    var count int
    var marker byte

    // %s 和 %d 读取字段时会按扫描规则处理空白；%c 直接取下一个字符。
    n, err := fmt.Sscanf(text, "%s %d%c", &label, &count, &marker)
    // 三个目标都成功写入，才把结果交给后续逻辑。
    if n != 3 {
        return "", 0, 0, fmt.Errorf("字段不完整：已读取 %d 个：%w", n, err)
    }
    return label, count, marker, nil
}

如果业务数据里必须区分空格、制表符或换行，不要凭直觉把格式模板写成“看起来差不多”。把空白规则写进接口约定，并用 n 和 err 把输入不足暴露给调用方。

按扫描数量处理输入不足和类型不匹配

扫描的返回数量是一个很实用的审计点：它能告诉你在错误发生前有多少个字段已经成功落入目标变量。类型不匹配、输入提前结束、格式中的换行与输入不一致，都可能让数量小于目标参数个数。

package main

import "fmt"

func parsePair(text string) (string, int, error) {
    var key string
    var value int

    // 这里故意要求第二个字段是整数，类型不匹配时会留下部分结果。
    n, err := fmt.Sscanf(text, "%s %d", &key, &value)
    if n != 2 {
        // 记录数量和原始错误，便于调用方区分坏输入与业务拒绝。
        return key, value, fmt.Errorf("解析键值对失败：已读取 %d 个：%w", n, err)
    }
    return key, value, nil
}

如果 err 可能为 nil，不要直接使用 %w 期待它提供有意义的原因；可以先补充业务错误，或把“数量不足”作为独立错误返回。对于不可信文本，还应限制输入长度，避免把格式扫描当成完整的安全边界。

什么时候不用 fmt.Sscanf

需要严格的字段校验、转义、引号、可选项或错误位置时，手写小型解析器通常更容易维护。只按空白分隔的输入可以选择 fmt.Sscan；需要从 io.Reader 连续读取时选择 fmt.Fscanf。Sscanf 的优势是格式直观，代价是格式字符串一旦承担太多业务规则，就会变得难以审查。

小结：

• 固定布局：格式模板 + 指针目标 + n/err 双重判断。
• 空白敏感：特别检查 %c 和格式中的换行。
• 复杂协议：尽早换成专用解析器，不把部分成功当成完整成功。

常见问题

fmt.Sscanf 为什么返回数量不足但变量已有值？

扫描是逐个目标进行的，前面的字段可能已经成功写入，后面的字段才遇到 EOF 或类型错误。因此必须同时判断数量和错误，不能因为第一个变量有值就认为整条记录有效。

格式里的空格只能匹配一个空格吗？

普通扫描规则会处理空白，不应把它简单理解成字节级的单个空格。若业务要求严格字符布局，使用更明确的解析逻辑，并把换行和 %c 的特殊行为单独写清楚。