Go 版本标准库变更速查

// Go 1.27: 泛型方法 — math/rand/v2 的 Rand 现在有泛型方法 N
r := rand.New(rand.NewPCG(1, 2))
n := r.N[int](100)   // 之前只能写包级函数 rand.N[int](100)

// Go 1.27: 结构体字面量用嵌套字段作 key
type Inner struct{ X int }
type Outer struct{ In Inner }
o := Outer{In.X: 42}   // 之前必须写 Outer{In: Inner{X: 42}}

// 1.27 起，time.After 的通道是无缓冲同步通道。
// 老代码里 "select 到 time.After 后想排空残留值" 的写法可以彻底删掉：
timer := time.NewTimer(time.Second)
defer timer.Stop()
// 1.23+ 已保证 Reset/Stop 语义清晰；1.27 进一步固化通道行为

// Go 1.27: 标准库 JSON 已默认走 v2 引擎
// 迁移要点：内嵌字段 tag 从 ,inline 改为 ,embed
type Embedded struct {
    A int
    B string
}
type Wrapper struct {
    Embedded `json:",embed"`   // v2；v1 老写法是 json:",inline"
    C        bool
}

// Go 1.27: strings.CutLast —— 取文件名后缀更直观
name, ext, hasExt := strings.CutLast("archive.tar.gz", ".")
// name="archive.tar", ext="gz", hasExt=true

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

// Go 1.26: new(expr) —— 注意是"单个表达式"，不是多字段构造
age := 42
p := new(age)              // *int，指向 age 的副本初值 42
// 常见于给指针型可选字段赋值：
type Person struct{ Age *int }
person := Person{Age: new(age)}

// 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()

file, _ := root.Open("subdir/file.txt")      // /safe/dir/subdir/file.txt
_, err := root.Open("../../../etc/passwd")   // err != nil，被拒绝

// Go 1.24: b.Loop() 取代脆弱的 for i:=0; i<b.N; i++
func BenchmarkX(b *testing.B) {
    for b.Loop() {
        doWork()
    }
}

// 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/maps 迭代器 + 收集
for i, v := range slices.All([]string{"a", "b"}) {
    fmt.Println(i, v)  // 0 a, 1 b
}
m := maps.Collect(maps.All(map[string]int{"x": 1}))  // 复制成 map

// Go 1.23: 更安全的 Timer.Reset —— 不再需要排空
timer := time.NewTimer(1 * time.Second)
timer.Reset(2 * time.Second)  // 直接 Reset 即可

// 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, envHost, "localhost")

// Go 1.22: slices.Concat
all := slices.Concat([]int{1, 2}, []int{3, 4}, []int{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() // 第一次执行，后续无操作

// Go 1.21: WithoutCancel — 适合请求结束后的异步清理
ctx := context.WithoutCancel(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])

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

// 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 cmp.Ordered](a, b T) T {
    if a > b { return a }
    return b
}

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

// Go 1.18: netip — 更安全、可比较
addr := netip.MustParseAddr("192.168.1.1")
prefix := netip.MustParsePrefix("10.0.0.0/8")
fmt.Println(prefix.Contains(addr))  // false

//go:build go1.24

// go.mod 中声明最低版本
go 1.24