Go meckert wegen go.mod? Warum das passiert und wie es funktioniert

Einleitung: Die vertraute Angst jedes Go-Anfängers

Sie fangen gerade an, Go zu lernen. Die Inspiration ist überwältigend, Sie schreiben Ihr erstes Hello, World!, führen go run main.go aus – und statt einer Begrüßung sehen Sie eine rote Textwand. Der Schlüsselsatz, der einem das Blut in den Adern gefrieren lässt: "go: go.mod file not found in current directory or any parent directory; see 'go help modules'".

Kommt Ihnen bekannt vor? Keine Sorge, diesen Fehler hat jeder gesehen, der mit Go ab Version 1.11 angefangen hat. Es ist kein Compiler-Bug und kein Fluch der alten Götter. Es ist der strenge, aber gerechte Mechanismus des Go-Modulsystems. Heute zeigen wir nicht nur, wie man ihn behebt (auch das werden wir tun). Wir schauen "unter die Haube": Wir verstehen, warum Go go.mod benötigt, wie es danach sucht und was passiert, wenn die Datei fehlt.

Am Ende des Artikels werden Sie den Fehler nicht nur los sein, sondern auch die gesamte Philosophie der Abhängigkeitsverwaltung in Go verstehen. Los geht's!

Was ist go.mod und wozu braucht Go es?

Stellen Sie sich go.mod als den Reisepass Ihres Projekts vor. In dieser Datei speichert Go drei wesentliche Dinge:

\n
• Den Modulnamen (z.B. example.com/myproject) – eine eindeutige Kennung.
\n
• Die Go-Version, mit der das Projekt geschrieben wurde.
\n
• Die Liste der Abhängigkeiten – welche externen Pakete Sie verwenden und deren genaue Versionen.
\n

Vor der Einführung von Modulen (in Go-Versionen < 1.11) war alles anders. Der Code musste streng im Ordner $GOPATH/src gespeichert werden. Das war umständlich: Sie konnten ein Repository nicht einfach in einen beliebigen Ordner klonen und ausführen. Das Modulsystem (Go modules) hat dieses Problem gelöst, indem es Projekte portabel und isoliert gemacht hat.

Jetzt betrachtet Go go.mod als die Grenze des Projekts. Wenn die Datei nicht existiert, geht Go davon aus, dass Sie außerhalb eines Projekts arbeiten, und weigert sich, den Code auszuführen. Das ist die Wurzel unseres Fehlers.

Wie Go nach go.mod sucht: Der "Bottom-Up"-Algorithmus

Wenn Sie go run main.go eingeben, startet Go die Suche nach go.mod nach folgendem Algorithmus:

\n
1. Beginne im aktuellen Verzeichnis. Wenn im Ordner, in dem main.go liegt, eine go.mod existiert – großartig, wir arbeiten damit.
\n
2. Wenn nicht – gehe eine Ebene höher (in das übergeordnete Verzeichnis). Überprüfe erneut.
\n
3. Wiederhole Schritt 2, bis du das Wurzelverzeichnis des Dateisystems erreichst (/ auf Linux/Mac oder C:\\ auf Windows).
\n
4. Wenn du die Wurzel erreichst und keine go.mod gefunden hast – gib den Fehler "go.mod file not found in current directory or any parent directory" aus.
\n

Dieser Algorithmus heißt "walk up the directory tree". Er ermöglicht es Ihnen, Code aus jedem beliebigen Unterordner innerhalb des Projekts auszuführen. Wenn Ihr Projekt z.B. in /home/user/myapp/ liegt und Sie in /home/user/myapp/cmd/ gehen und go build ausführen, findet Go die go.mod in /home/user/myapp/.

Praktisches Beispiel: Den Fehler reproduzieren

Lassen Sie uns die Situation simulieren. Erstellen wir eine einfache Datei ohne Modul:

// main.go\npackage main\n\nimport "fmt"\n\nfunc main() {\n    fmt.Println("Hallo aus der Welt ohne go.mod!")\n}

Jetzt versuchen wir, es auszuführen:

$ go run main.go\ngo: go.mod file not found in current directory or any parent directory; see 'go help modules'

Da ist er, unser Fehler. Go ist ehrlich alle Ordner vom aktuellen bis zur Wurzel durchgegangen, hat aber keine go.mod gefunden. Die Lösung liegt auf der Hand: Wir müssen diese Datei erstellen.

Wie man den Fehler richtig behebt

Methode 1: Schnellstart mit go mod init

Der korrekteste Weg ist die Initialisierung eines Moduls:

$ go mod init example.com/myfirstapp\ngo: creating new go.mod: module example.com/myfir