Go Home Page
Die Programmiersprache Go

Installing Go from source — Deutsche Übersetzung

Das Original:
https://golang.org/doc/install-source.html
Version of December 7, 2019 (go1.14)
Diese Übersetzung:
https://bitloeffel.de/DOC/golang/install-source_20200226_de.html
Stand: 21.12.2019
© 2015-20 Hans-Werner Heinzen @ Bitloeffel.de
Die Nutzung dieses Werks ist unter den Bedingungen der "Creative Commons Attribution 3.0"-Lizenz erlaubt.
Für Fachbegriffe und ähnliches gibt es hier noch eine Wörterliste.

Go installieren (aus den Quellen)

Einführung

Go ist ein quelloffenes Projekt, das unter einer Lizenz ähnlich der BSD-Lizenz veröffentlicht wurde. Dieses Dokument erklärt, wie man an die Quellen herankommt und wie man sie auf dem eigenen Rechner kompiliert und zum Laufen bringt.

Den meisten wird es genügen, stattdessen nur die vorkompilierten Pakete zu installieren, so wie es in "Getting Started" ("Anfangen") beschrieben ist — das ist viel einfacher. Wenn Sie allerdings beim Entwickeln der genannten Pakete mithelfen wollen, dann lesen Sie weiter!

Es gibt zwei offizielle Werkzeugsätze zum Kompilieren von Go. Dieses Dokument hat den gc-Go-Compiler und zugehörige Tools im Blick. Informationen zu dem eher traditionellen Compiler gccgo, der das GCC-Back-End benutzt, finden Sie in "Setting up and using gccgo".

Die Go-Compiler unterstützen zwölf Befehlssätze.

amd64, 386
Der x86-Befehlssatz, 64- and 32-Bit.
arm64, arm
Der ARM-Befehlssatz, 64-Bit (AArch64) und 32-Bit.
ppc64, ppc64le
Der 64-Bit-PowerPC-Befehlssatz, Big- und Little-endian.
s390x
Die IBM z/-Architektur.
mips64, mips64le, mips, mipsle
Der MIPS-Befehlssatz, Big- and Little-Endian, 64- und 32-Bit.
wasm
WebAssembly.

Die Compiler können die Betriebssysteme AIX, Android, DragonFly BSD, FreeBSD, Illumos, Linux, macOS/iOS (Darwin), NetBSD, OpenBSD, Plan 9, Solaris und Windows zum Ziel haben (wenn auch nicht jedes Betriebssystem alle Architekturen unterstützt).

Eine Liste der Portierungen, die als "First Class" angesehen werden, gibt es auf der Wiki-Seite first class ports

Die vollständige Liste möglicher Kombinationen befindet sich weiter unten bei der Diskussion der Umgebungsvariablen.

Auf der Haupt-Installationsseite finden Sie die allgemeinen Systemvoraussetzungen (de). Für Systeme, die nur aus dem Quellkode erzeugt werden können, gilt außerdem noch folgendes:

Installieren Sie die Go-Compiler-Binärdateien

Der gesamte Go-Werkzeugsatz wurde in Go geschrieben. Um ihn umwandeln zu können, müssen Sie schon einen Go-Compiler installiert haben. Die Skripte, die die Werkzeuge erstmalig umwandeln, suchen nach einem bereits vorhandenen Werkzeugsatz in $GOROOT_BOOTSTRAP. Wurde diese Variable nicht gesetzt, so greift der Vorgabewert von GOROOT_BOOTSTRAP, nämlich $HOME/go1.4.

Es gibt viele Möglichkeiten, sich den Starthilfe-Werkzeugsatz (bootstrap tool chain) zu besorgen. Wenn sie das getan haben, setzen Sie GOROOT_BOOTSTRAP so, dass er den Namen des Ordners für den entpackten Baum enthält. Zum Beispiel sollte dann $GOROOT_BOOTSTRAP/bin/go die Binärdatei des go-Kommandos für den Starthilfe-Werkzeugsatz sein.

"Bootstrap"-Werkzeugsatz einer Binär-Auslieferung

Wenn Sie ein Binär-Release als Starthilfe-Werkzeugsatz benutzen wollen, finden Sie die auf der Download-Seite; oder nutzen Sie das Go-Paket einer beliebigen Distribution.

"Bootstrap"-Werkzeugsatz aus den Quellen

Um den Starthilfe-Werkzeugsatz aus seinen Quelldateien zu bauen, benutzen Sie entweder aus dem Git-Repositorium den Zweig release-branch.go1.4, oder sie besorgen sich go1.4-bootstrap-20171003.tar.gz, worin sich der Quellkode von Go 1.4 befindet, mit einer Reihe von Korrekturen, die dafür sorgen, dass die Werkzeuge auch auf neueren Betriebssystemen laufen. (Go 1.4 war die letzte Go-Version, deren Compiler in C geschrieben war.) Nachdem Sie den Go-1.4-Quellkode ausgepackt haben, wechseln Sie zum Unterordner src, setzen Sie die Umgebungsvariable CGO_ENABLED=0 und starten Sie make.bash, oder für Windows make.bat.

Haben Sie die Go-1.4-Quellen erstmal in ihrem GOROOT_BOOTSTRAP-Ordner ausgepackt, so müssen Sie diese mit git clone erzeugte Instanz weiterhin im Zustand release-branch.go1.4 halten. Versuchen Sie also nicht, sie für den späteren Arbeitsschritt "Kopieren Sie das Repositorium" wiederzuverwenden. Der Go-1.4-Starthilfe-Werkzeugsatz muss in der Lage sein die Go-1.4-Quellen dort zu durchsuchen, wo sie sie unterhalb dieses Wurzelverzeichnisses sucht.

"Bootstrap"-Werkzeugsatz aus fremdkompilierten Quellen

Startet man zum Beispiel ein Fremdkompilieren mit: 

$ GOOS=linux GOARCH=ppc64 ./bootstrap.bash

so erzeugt bootstrap.bash den Werkzeugsatz für diese GOOS/GOARCH-Kombination und hinterlegt den erzeugten Verzeichnisbaum unter ../../go-${GOOS}-${GOARCH}-bootstrap. Diesen Verzeichnisbaum kann man nun auf's Zielsystem übertragen und als GOROOT_BOOTSTRAP für den lokalen Bau der Werkzeuge benutzen.

"Bootstrap"-Werkzeugsatz unter Verwendung von gccgo

Wenn Sie gccgo als Starthilfe-Werkzeugsatz benutzen wollen, so müssen Sie dafür sorgen, dass das go-Tool, welches Teil von gccgo 5 ist, über $GOROOT_BOOTSTRAP/bin/go zu finden ist. Hier zum Beispiel, unter Ubuntu Vivid: 

$ sudo apt-get install gccgo-5
$ sudo update-alternatives --set go /usr/bin/go-5
$ GOROOT_BOOTSTRAP=/usr ./make.bash

Installieren Sie Git, wenn nötig

Für den nächsten Schritt müssen Sie Git installiert haben; kontrollieren Sie also, ob das Kommando git zur Verfügung steht.

Haben Sie noch kein arbeitsfähiges Git, folgen Sie den Anweisungen auf der "Git Downloads"-Seite.

(Optional) Installieren Sie einen C-Compiler

Wenn Ihre Go-Installation cgo unterstützen soll, damit Go-Programme auch C-Bibliotheken importieren können, so müssen Sie zunächst einen C-Compiler wie gcc oder clang installieren. Tun Sie das mit der für Ihr System üblichen Methode.

Um Go ohne cgo-Unterstützung zu installieren, setzten Sie CGO_ENABLED=0 bevor Sie all.bash oder make.bash (siehe unten) starten.

Kopieren Sie das Repositorium

Go wird in einem Ordner namens go installiert. Wechseln Sie in den Ordner, in dem Sie Go installieren wollen, und stellen Sie sicher, dass dort ein Ordner goroot noch nicht existiert. Dann klonen Sie das Repositorium und buchen zur letzten Freigabemarke (zum Beispiel go1.12) aus: 

$ git clone https://go.googlesource.com/go goroot
$ cd goroot
$ git checkout <Marke>

<Marke> steht hier für den Version-String der Freigabe (release).

Go wird in dem Ordner installiert, in den es ausgebucht wird. Wird beispielsweise Go nach $HOME/goroot ausgebucht, so wandern die Laufzeitmodule nach $HOME/goroot/bin. Der Ordner kann beliebig benannt werden - beachten Sie aber, dass, wenn Sie nach $HOME/go ausbuchen, das mit dem Standard für $GOPATH kollidiert. Siehe unten unter GOPATH.

Nicht vergessen: Wenn Sie sich weiter oben für das Kompilieren des Starthilfe-Werkzeugsatzes aus den Quellen entschieden haben, müssen Sie hier noch einmal git clone einsetzen (um bei der neuesten <Marke> auszubuchen), denn Sie müssen das Go-1.4-Repositorium getrennt halten.

Wenn Sie Go-Quellkode verändern und mit Ihren Änderungen zum Projekt beitragen wollen, dann stellen Sie Ihr Repositorium vom "release"-Zweig auf den "master"-Zweig (Entwicklungszweig) um. Wenn nicht, überspringen Sie diesen Schritt. 

$ git checkout master

Installieren Sie Go

Um Go zusammenzubauen, geben Sie ein: 

$ cd src
$ ./all.bash

(In Windows benutzen Sie all.bat.)

Wenn alles gut geht, wird am Ende etwa folgendes ausgegeben: 

ALL TESTS PASSED

---
Installed Go for linux/amd64 in /home/you/go.
Installed commands in /home/you/go/bin.
*** You need to add /home/you/go/bin to your $PATH. ***

Dabei beziehen sich die Details der letzten Zeilen auf Betriebssystem, Architektur und den Ordner, der bei der Installation als Wurzel verwendet wurde.

Zusätzliche Info darüber, wie man den Zusammenbau steuern kann, gibt's weiter unten bei der Diskussion der Umgebungsvariablen. Bei all.bash (oder all.bat) laufen auch wichtige Tests, die eventuell viel mehr Zeit brauchen als das reine Zusammenbauen von Go. Wenn Sie auf die Tests verzichten wollen, starten Sie alternativ make.bash (oder make.bat).

Die Installation testen

Prüfen Sie die Korrektheit der Installation, indem Sie ein einfaches Programm umwandeln und laufen lassen.

Erzeugen Sie eine Datei mit Namen hello.go und darin folgendes Programm: 

package main

import "fmt"

func main() {
    fmt.Printf("Hallo Welt\n")
}

Starten Sie das Programm mit dem Kommando go: 

$ go run hello.go
Hallo Welt

Wenn die Nachricht "Hallo Welt" zu sehen ist, dann wurde Go korrekt installiert.

Vorbereiten der Entwicklungsumgebung

Sie sind fast fertig - nur noch wenige vorbereitende Schritte.

How to Write Go Code Learn how to set up and use the Go tools

Das Dokument "How to Write Go Code" ("Wie man mit Go arbeitet") beschreibt wichtige Arbeitsschritte vor dem Benutzen der Go-Werkzeuge.

Installieren von Zusatzwerkzeugen

Der Quellkode verschiedener Go-Werkzeuge, darunter der für godoc befindet sich in einem getrennten go.tools-Repositorium. Um eines der Werkzeuge zu installieren (in diesem Fall godoc), starten Sie: 

$ go get golang.org/x/tools/cmd/godoc

Das Kommando go get setzt hier das Vorhandensein von Git voraus.

Außerdem müssen ein Arbeitsbereich (GOPATH) festgelegt haben; genaueres in "Wie man mit Go arbeitet".

Die Go-Gemeinde als Ressource

An den üblichen Versammlungsplätzen der Go-Gemeinde wie #go-nuts beim Freenode-IRC-Server oder der "Go Nuts"-Verteilerliste finden Sie aktive Entwickler, die Ihnen bei Problemen mit Ihrer Installation und Entwicklerproblemen helfen können. Wer immer auf dem neuesten Stand sein will, für den empfängt die Verteilerliste golang-checkins für jedes Einbuchen ins Go-Repositorium eine zusammenfassende Nachricht.

Fehler können Sie melden beim Go-Fallbearbeitungssystem.

Schritt halten mit den Freigaben

Neue Freigaben (releases) werden in golang-announce angekündigt. Jede Ankündigung enthält die Freigabemarke, zum Beispiel go1.9.

Um Ihren Ordnerbaum auf die letzte Freigabe zu aktualisieren, schreiben Sie: 

$ cd go/src
$ git fetch
$ git checkout <Marke>
$ ./all.bash

<Marke> steht hier für den Version-String der Freigabe.

(Optional) Umgebungsvariablen

Die Go-Umwandlungsumgebung kann durch Umgebungsvariablen angepasst werden. Es sind zwar keine nötig, aber vielleicht wollen Sie ein paar Voreinstellungen überschreiben.

Beachten Sie, dass $GOARCH und $GOOS für das Zielsystem stehen, nicht für Ihre Entwicklungsumgebung. Das bedeutet, dass es sich eigentlich immer um Fremdkompilieren handelt. Mit Architektur ist die Art Binärdatei gemeint, die auf einem Zielsystem laufen kann: Auf einem x86-64-System, auf dem nur ein 32-Bit-Betriebssystem läuft, muss GOARCH auf 386 (und nicht amd64) gesetzt sein.

Wenn Sie Vorgabewerte überschreiben wollen, tun Sie das in Ihrer Shell-Profildatei ($HOME/.bashrc, $HOME/.profile oder einer Entsprechung). Das mag dann so aussehen: 

export GOARCH=amd64
export GOOS=linux

Allerdings, um's nochmal zu wiederholen: Keine dieser Variablen muss fürs Kompilieren, Installieren oder Weiterentwickeln des Go-Verzeichnisbaums gesetzt werden!