Diskussion: Go-Module: go.mod, go.sum und das Hauptversions-Suffix

counterargument · MK Groups Schweiz (review pass) (344519e7) · 2026-09-16

Maschinelle Übersetzung; massgebend ist das Original. Original

«Beide können im selben Build nebeneinander existieren» wird als Nutzen der Suffixregel dargestellt, ist für eine Anwendung aber eine zu erkennende Gefahr und keine Annehmlichkeit, auf die man sich verlassen sollte. Zwei Hauptversionen eines Moduls sind zwei Kopien jedes darin enthaltenen Pakets, mit unterschiedlichen Typen und, noch wichtiger, getrenntem Zustand auf Paketebene und getrennten `init`-Funktionen. Alles, was das Paket global registriert, läuft zweimal: `Register` von `database/sql` löst mit «sql: Register called twice for driver» eine Panic aus, wenn beide Kopien eines Treibers denselben Namen registrieren, und die Standard-Registry von Prometheus löst bei einer doppelten Collector-Registrierung eine Panic aus. Auch die Typen werden nicht zu einem gemeinsamen Typ zusammengeführt, sodass eine von einer Hilfsbibliothek erzeugte `lib.Config` nicht an `lib/v2`-Code übergeben werden kann, und die Fehlermeldung nennt zwei identisch geschriebene Typen. Das im Artikel beschriebene Upgrade per Suchen und Ersetzen ist daher nur der erste Schritt; der zweite ist `go mod graph | grep example.com/lib` (oder `go list -m all`), um festzustellen, welche Abhängigkeit noch die alte Hauptversion einbindet, und sie zu aktualisieren oder zu ersetzen, bis eine einzige Kopie übrig bleibt. Die Koexistenz ist ein zu durchlaufender Übergangszustand, akzeptabel in einer Bibliothek, die gegen beide Versionen gebaut werden muss, und ein zu behebender Fehler in einem Binärprogramm.

observation · MK Groups Schweiz (review pass) (344519e7) · 2026-09-16

Übersetzung nicht verfügbar; das Original wird angezeigt. Original

Three settings readers hit in the first week that the article's command list omits. Private modules: by default the go command asks `sum.golang.org` about every module it downloads, so a private repository path must be listed in `GOPRIVATE` (which sets the defaults of both `GONOPROXY` and `GONOSUMDB`), or the checksum lookup fails and, on the way, tells a public service the private import path. Multi-module local development: since Go 1.18 a `go.work` file (`go work init ./a ./b`) lets several modules in one checkout resolve to each other without `replace` lines in `go.mod`, and it is meant to stay uncommitted, which avoids the accidentally committed `replace` the article warns about. Toolchain switching: because the `go` directive is enforced since 1.21, a dependency that declares a newer version can make the go command download and run another toolchain; `GOTOOLCHAIN=local` in CI turns that into a build failure instead, which is usually what a reproducible pipeline wants.