What’s New in Go 1.25? Key Toolchain, Runtime, and Library Enhancements

Toolchain and go command

The new -asan flag is enabled by default to detect C memory leaks at program exit; it can be disabled with ASAN_OPTIONS=detect_leaks=0 ./myprogram.

A new ignore directive in go.mod lets the go command skip specified directories when matching ./... or all, while still including them in packages.

// go.mod
module example.com/project

go 1.25

ignore tools

Running go test ./... will now ignore the tools directory.

The go doc -http=:6060 fmt command starts a local documentation server, opening the fmt package in the browser. go version -m -json ./mybinary prints the embedded BuildInfo JSON, making version tracking easier.

go vet new analyzer

WaitGroup check

The analyzer warns when WaitGroup.Add is called inside a goroutine, catching common misuse.

var wg sync.WaitGroup
wg.Add(1)
go func() {
    defer wg.Done()
    // do work
}()
wg.Wait()

Hostport check

Prefer net.JoinHostPort(host, strconv.Itoa(port)) over manual string formatting to avoid IPv6 issues.

Go Runtime optimizations and upgrades

Container‑aware GOMAXPROCS

Since Go 1.25, the runtime automatically adjusts GOMAXPROCS based on cgroup CPU limits, which is especially useful in Kubernetes and other cloud environments. The default can be forced with runtime.SetDefaultGOMAXPROCS() or disabled via GODEBUG=containermaxprocs=0,updatemaxprocs=0.

Experimental GC (greenteagc)

Enabling GOEXPERIMENT=greenteagc activates a new GC algorithm that reduces overhead for many small allocations by 10‑40%.

GOEXPERIMENT=greenteagc go build

Trace Flight Recorder

The new Flight Recorder captures recent trace events in a circular buffer and writes them to a file for later analysis.

fr := trace.NewFlightRecorder()
defer fr.Stop()

f, _ := os.Create("trace.out")
fr.WriteTo(f)

Standard library optimizations

Experimental encoding/json/v2

JSON decoding performance is significantly improved; the API remains compatible, though error messages may differ.

GOEXPERIMENT=jsonv2 go build

sync.WaitGroup.Go

A new method that automatically calls Add and Done, reducing boilerplate.

var wg sync.WaitGroup
wg.Go(func() {
    fmt.Println("Hello Go 1.25")
})
wg.Wait()

net/http.CrossOriginProtection

A middleware that checks the request Origin or Fetch Metadata (e.g., Sec‑Fetch‑Site) and rejects unsafe cross‑site POSTs, providing CSRF protection without tokens.

handler := http.NewServeMux()
handler.Handle("/", http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
    w.Write([]byte("OK"))
}))
http.ListenAndServe(":8080", http.CrossOriginProtection(handler, nil))

reflect.TypeAssert

This function converts a reflect.Value directly to a typed Go value, avoiding the allocation incurred by Value.Interface().

v := reflect.ValueOf(123)
n := reflect.TypeAssert[int](v, "int") // no extra allocation

System version support changes

macOS : minimum supported version is 12 Monterey.

Windows : Go 1.25 is the last release supporting 32‑bit Windows/ARM.

Loong64 / RISC‑V : race detector and plugin mode are now available.

Conclusion

Go 1.25 does not introduce major language changes, but it delivers meaningful improvements in the toolchain, runtime, and performance. Notable upgrades include container‑aware GOMAXPROCS, the experimental greentea GC, and the faster encoding/json/v2 implementation.