cmd/go: compile error for "toolchain default" in go.mod, removed by mod tidy

[Snawoot]

Go version

go version go1.24.1 linux/amd64

Output of go env in your module/workspace:

AR='ar'
CC='gcc'
CGO_CFLAGS='-O2 -g'
CGO_CPPFLAGS=''
CGO_CXXFLAGS='-O2 -g'
CGO_ENABLED='1'
CGO_FFLAGS='-O2 -g'
CGO_LDFLAGS='-O2 -g'
CXX='g++'
GCCGO='gccgo'
GO111MODULE=''
GOAMD64='v1'
GOARCH='amd64'
GOAUTH='netrc'
GOBIN=''
GOCACHE='/home/user/.cache/go-build'
GOCACHEPROG=''
GODEBUG=''
GOENV='/home/user/.config/go/env'
GOEXE=''
GOEXPERIMENT=''
GOFIPS140='off'
GOFLAGS=''
GOGCCFLAGS='-fPIC -m64 -pthread -Wl,--no-gc-sections -fmessage-length=0 -ffile-prefix-map=/tmp/go-build416208600=/tmp/go-build -gno-record-gcc-switches'
GOHOSTARCH='amd64'
GOHOSTOS='linux'
GOINSECURE=''
GOMOD='/home/user/src/test/go.mod'
GOMODCACHE='/home/user/go/pkg/mod'
GONOPROXY=''
GONOSUMDB=''
GOOS='linux'
GOPATH='/home/user/go'
GOPRIVATE=''
GOPROXY='https://proxy.golang.org,direct'
GOROOT='/usr/lib64/go/1.24'
GOSUMDB='sum.golang.org'
GOTELEMETRY='local'
GOTELEMETRYDIR='/home/user/.config/go/telemetry'
GOTMPDIR=''
GOTOOLCHAIN='local'
GOTOOLDIR='/usr/lib64/go/1.24/pkg/tool/linux_amd64'
GOVCS=''
GOVERSION='go1.24.1'
GOWORK=''
PKG_CONFIG='pkg-config'

What did you do?

I'm following go.mod specification which allows to disable automatic toolchain switching with toolchain default directive.

I'm using following minimal example to reproduce the issue:

main.go

package main

import "fmt"

func main() {
	fmt.Println("Hello, World!")
}

go.mod

module github.com/Snawoot/test

go 1.24.1

toolchain default

What did you see happen?

Attempt to build or run it produces requires go mod tidy and ends up with following error:

$ go run .
go: updates to go.mod needed; to update it:
	go mod tidy

But running go mod tidy strips toolchain directive and leaves me with following go.mod

module github.com/Snawoot/test

go 1.24.1

What did you expect to see?

I expect go build and go run to not have false positive about "dirty" go.mod and run it with original go.mod without any issue. Also I expect go mod tidy to respect specification and preserve directives I've set.

[ldemailly]

default btw is a weird name for something that would work like GOTOOLCHAIN=local so should be local instead (neither work)

[gabyhelp]

Related Issues

• go mod tidy removes the toolchain directive #64039 (closed)
• cmd/go: go get -u && go mod tidy behaves differently starting with Go 1.21.0, leading to unknown directive toolchain errors #62409 (closed)
• cmd/go: mod tidy reports toolchain not available with 'go 1.21' #62278 (closed)
• cmd/go: toolchain directive in go.mod being updated unnecessarily #65847 (closed)
• cmd/go: go mod tidy reverts upgrade #38985 (closed)
• cmd/go: go toolchain version switch doesn't work when only language version is set in go.mod #65580 (closed)
• go run not adhering to toolchain of go.mod when specifying package version #69817 (closed)
• cmd/go: error out in 'go mod tidy' if the result uses a module for multiple paths #34650 (closed)
• cmd/go: run constantly fails and suggests 'go mod tidy' #41416 (closed)

Related Code Changes

• cmd/go: adjust conditions in which toolchain lines are written

_{(Emoji vote if this was helpful or unhelpful; more detailed feedback welcome in this discussion.)}

[ldemailly]

@seankhliao it's not a warning, it's an error, go run . fails/stops with

go: updates to go.mod needed; to update it:
	go mod tidy

[Snawoot]

@seankhliao Sorry, but updated title is outright wrong. It's not a warning, it's ultimately a failure to compile. Editing title.

[03094299179]

$ go run . go: updates to go.mod needed; to update it: go mod tidy