Go 版本标准库变更速查

// Go 1.26: 递归泛型 — 接口约束可以引用自身
type Mergeable[T Mergeable[T]] interface {
    Merge(other T) T
}

// Go 1.26: new(expr) — 带初始化表达式的 new
p := new(int, 42)        // *int, 指向 42
s := new(MyStruct, "a", 1) // 等价于 &MyStruct{Field1: "a", Field2: 1}

// Go 1.26 实验性：泛型方法 (GOEXPERIMENT=genericmethods)
func (b *Builder) Build[T any]() (T, error) { ... }
user, err := b.Build[User]()

// Go 1.25: 无「核心类型」后，更宽泛的约束变得合法
type Sliceable interface { ~[]byte | ~string }
func Slice[T Sliceable](s T) T {
    return s[1:3]  // Go 1.25: ✅ 合法（之前：❌ 无核心类型）
}

// Go 1.24: 泛型类型别名
type Set[K comparable] = map[K]struct{}  // 别名，非新类型

// Go 1.24: os.Root — 安全的文件系统沙箱
root, _ := os.OpenRoot("/safe/dir")
defer root.Close()

// 所有操作被限制在 /safe/dir 下
file, _ := root.Open("subdir/file.txt")      // ✅ /safe/dir/subdir/file.txt
file, _ := root.Open("../../../etc/passwd")  // ❌ 拒绝访问！

// Go 1.23: slices.Repeat
s := slices.Repeat([]string{"a", "b"}, 3)
// → ["a", "b", "a", "b", "a", "b"]

// Go 1.23: 更安全的 Timer.Reset
timer := time.NewTimer(1 * time.Second)
// 不再需要：
// if !timer.Stop() { <-timer.C }
timer.Reset(2 * time.Second) // 直接 Reset 即可

// Go 1.23: range over func — 自定义迭代器
func countdown(n int) iter.Seq[int] {
    return func(yield func(int) bool) {
        for i := n; i > 0; i-- {
            if !yield(i) { return }
        }
    }
}
for v := range countdown(3) {
    fmt.Println(v)  // 3, 2, 1
}

// Go 1.23: slices 迭代器
for i, v := range slices.All([]string{"a", "b"}) {
    fmt.Println(i, v)  // 0 a, 1 b
}

// Go 1.22: 增强路由
mux := http.NewServeMux()
mux.HandleFunc("GET /users/{id}", func(w http.ResponseWriter, r *http.Request) {
    id := r.PathValue("id")  // 提取路径参数
    fmt.Fprintf(w, "User: %s", id)
})

// Go 1.22: cmp.Or
host := cmp.Or(cfg.Host, "localhost")  // 等价于 if cfg.Host != "" { host = cfg.Host } else { host = "localhost" }

// Go 1.22: slices.Concat
all := slices.Concat([]int{1, 2}, []int{3, 4}, []int{5})
// → [1, 2, 3, 4, 5]

// Go 1.21: slog 结构化日志
logger := slog.New(slog.NewJSONHandler(os.Stdout, nil))
logger.Info("request", "method", "GET", "path", "/api", "latency", 5*time.Millisecond)

// Go 1.21: OnceFunc
var initDB = sync.OnceFunc(func() {
    db = connectDB()
})
initDB() // 第一次调用执行
initDB() // 后续调用无操作

// Go 1.21: WithoutCancel
ctx := context.WithoutCancel(parentCtx)
// ctx 不会随 parentCtx 的取消而取消，适合异步清理任务

// Go 1.20: errors.Join
err := errors.Join(err1, err2, err3)
// errors.Is(err, err1) → true

// Go 1.20: 终于不需要手写格式字符串了
fmt.Println(time.Now().Format(time.DateTime)) // "2006-01-02 15:04:05"

// Go 1.20: 释放大字符串的底层内存
sub := strings.Clone(bigString[1000:1010]) // sub 不再持有 bigString 的底层数组

// Go 1.19: 原子类型
var count atomic.Int64
count.Add(1)
val := count.Load()

var ready atomic.Bool
ready.Store(true)

// Go 1.19: URL 安全拼接
u, _ := url.Parse("https://example.com/api")
full, _ := u.JoinPath("v1", "users") // https://example.com/api/v1/users

// Go 1.18: 泛型
func Max[T constraints.Ordered](a, b T) T {
    if a > b { return a }
    return b
}

// Go 1.18: strings.Cut
before, after, found := strings.Cut("key=value", "=")
// before="key", after="value", found=true

// Go 1.18: netip — 更安全、可比较、占用更小
addr := netip.MustParseAddr("192.168.1.1")     // 不可变类型
prefix := netip.MustParsePrefix("10.0.0.0/8")  // CIDR
fmt.Println(prefix.Contains(addr))             // false

// 使用 build tags
//go:build go1.21

// 使用 Go 1.21+ 的 go.mod 版本指令
// go 1.21

// 检查是否有某个符号/包
// 通常不推荐运行时判断，应依赖编译时语义