高级“fmt”

fmt 包是 Go 中所有文本 I/O 的网关。充分了解它意味着编写可读日志、信息性错误以及惯用的格式化值，而无需求助于外部库。

四个家庭

fmt 公开四个系列的函数，按前缀区分：

• Print* → 写入 os.Stdout (Print、Println、Printf)。
• Fprint* → 写入任何 io.Writer (Fprintln(os.Stderr, ...), Fprintf(file, ...))。
• Sprint* → 返回一个字符串而不打印（Sprintf，Sprintln）。
• Errorf → 构建格式化的 error。

fmt.Println("hello")                       // stdout
fmt.Fprintln(os.Stderr, "boom")            // stderr
s := fmt.Sprintf("[%d]", 42)               // "[42]"
err := fmt.Errorf("parse %q: %w", in, base) // wrapped error

Print 和 Println 之间的区别仅在于参数和尾随换行符之间的空格：Println 始终添加 \n，Print 不添加，Printf 遵循格式。

主要动词

type Point struct{ X, Y int }
p := Point{1, 2}
fmt.Printf("%v\n", p)   // {1 2}
fmt.Printf("%+v\n", p)  // {X:1 Y:2}
fmt.Printf("%#v\n", p)  // main.Point{X:1, Y:2}
fmt.Printf("%T\n", p)   // main.Point

宽度、精度、标志

数字和字符串动词接受 宽度 和 精度：

• %6d → 最小宽度 6，左侧填充空格。
• %-6d → 宽度 6，右填充（标志 -）。
• %06d → 宽度 6，用 0 填充（标志 0）。
• %.2f → 精度 2 位小数。
• %8.2f → 宽度 8，精度 2。

fmt.Printf("|%6d|\n", 42)    // |    42|
fmt.Printf("|%-6d|\n", 42)   // |42    |
fmt.Printf("|%06d|\n", 42)   // |000042|
fmt.Printf("|%8.2f|\n", 3.14)// |    3.14|

对于对齐的表，在移动到 text/tabwriter 之前，文本列的固定宽度 + %-...s 是最简单的模式。

%w 和错误包装

%w 很特殊：它仅在 fmt.Errorf 内部工作，并保留链中的原始错误，以便 errors.Is 和 errors.As 可以遍历它。

if _, err := os.Open(path); err != nil {
    return fmt.Errorf("read config %q: %w", path, err)
}

使用 %v 而不是 %w 打印错误消息，但会破坏链条：没有解开，没有 errors.Is。规则：如果您希望调用者能够区分错误的类型或标识，请使用 %w （每个 Errorf 只能使用一个）。

练习

err := fmt.Errorf("read %q: ???", path, base)