Go 的 fmt 包支持通过 [n] 语法按位置引用参数，实现灵活的格式化输出；但需注意：必须配合正确的格式动词（如 %d、%s），且 Fprintf 需传入 io.Writer（如 os.Stdout），不可直接对字符串调用。
go 的 fmt 包支持通过 `[n]` 语法按位置引用参数，实现灵活的格式化输出；但需注意：必须配合正确的格式动词（如 `%d`、`%s`），且 `fprintf` 需传入 `io.writer`（如 `os.stdout`），不可直接对字符串调用。
在 Go 中，fmt 包提供了强大的格式化能力，其中「显式参数索引」（Explicit Argument Indexes）是一项常被忽略但极具实用价值的特性。它允许你通过 %[n]v 的形式，明确指定使用第 n 个（从 1 开始计数）传入的参数，从而打破默认按顺序消费参数的限制，提升模板复用性与可读性。
✅ 正确用法要点
- 必须搭配格式动词：%[1] 单独出现是非法的，需写成 %[1]d（整数）、%[1]s（字符串）、%[1]v（通用值）等；
-
Printf vs Fprintf 的区别：
- fmt.Printf(format, args...)：直接输出到标准输出（os.Stdout），无需额外 writer；
- fmt.Fprintf(w io.Writer, format, args...)：需显式传入一个实现了 io.Writer 接口的对象（如 os.Stdout、os.Stderr 或 bytes.Buffer），不能传字符串或字面量；
- 错误示例 fmt.Fprintf("%[1] %[2]", a, b) 会报错 "string does not implement io.Writer"，正是因为第一个参数被误当作 io.Writer，而非格式字符串。
? 完整可运行示例
package main
import (
"fmt"
"os"
)
func main() {
a, b, c, d := 42, "hello", 3.14, true
// ✅ 使用 Printf：简洁，适合标准输出
fmt.Printf("第一项：%[1]d，第三项：%[3]g，第二项：%[2]s\n", a, b, c, d)
// 输出：第一项：42，第三项：3.14，第二项：hello
// ✅ 使用 Fprintf：需指定 writer（如 os.Stdout）
fmt.Fprintf(os.Stdout, "重复使用第二项：%[2]s —— 还是 %[2]s\n", a, b, c, d)
// 输出：重复使用第二项：hello —— 还是 hello
// ✅ 混合索引与宽度/精度（例如 %[2]*.[1]*f 表示：第2个参数为 float 值，第1个为宽度，第3个为精度）
width, prec := 8, 3
fmt.Printf("%[3]*.[2]*f\n", width, prec, 3.14159) // 等价于 fmt.Printf("%8.3f\n", 3.14159)
// 输出： 3.142
}
⚠️ 注意事项
- 索引 [n] 是一阶索引（1-indexed），n 超出参数数量将导致 panic；
- 同一格式字符串中可多次引用同一索引（如 %[1]s %[1]s），非常适合模板化日志或重复字段；
- 在 Sprintf 中同样适用，用于生成字符串而不输出：
s := fmt.Sprintf("Code: %[2]d, Name: %[1]s", "APIError", 500) → "Code: 500, Name: APIError"； - 不要在 Println / Print 系列函数中使用 [n] 语法——它们不支持格式化动词和索引，仅作原样打印。
掌握显式参数索引，不仅能写出更健壮、可维护的格式化代码，还能在国际化（i18n）场景中轻松适配不同语序的语言需求。建议在日志、错误信息、CLI 输出等需要结构化文本的场景中优先采用。
