Skip to content

builder: suggest GOTOOLCHAIN and -go-compatibility when the host Go is too new - #5643

Open
0pcom wants to merge 1 commit into
tinygo-org:devfrom
0magnet:go-version-error-hint
Open

builder: suggest GOTOOLCHAIN and -go-compatibility when the host Go is too new#5643
0pcom wants to merge 1 commit into
tinygo-org:devfrom
0magnet:go-version-error-hint

Conversation

@0pcom

@0pcom 0pcom commented Sep 1, 2026

Copy link
Copy Markdown
Contributor

The window between a Go release and the TinyGo release that supports it is when most users hit the version gate (for example go1.27 with TinyGo 0.41.x), and the error gives no way forward.

Both escape hatches already exist: GOTOOLCHAIN=go1.<max>.x makes the go command download and run a supported toolchain — TinyGo follows it transparently, verified with GOTOOLCHAIN=go1.26.0 tinygo version reporting the switched toolchain — and -go-compatibility=false (v0.40.0, #5075) skips the check outright. This mentions both in the too-new case, so the gap between releases self-serves instead of requiring a Go downgrade. The too-old case keeps the plain message.

Message-only change; go build ./builder passes.

…s too new

The window between a Go release and the TinyGo release that supports it
is when most users hit the version gate, and the error gives no way
forward. Both escape hatches already exist: GOTOOLCHAIN=go1.<max>.x
makes the go command download and run a supported toolchain (TinyGo
follows it transparently), and -go-compatibility=false skips the check.
Mention them in the too-new case; the too-old case keeps the plain
message.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant