Installing Go from source — Deutsche Übersetzung
- Das Original:
-
https://golang.org/doc/install-source.html
Version of June 19, 2018 (go1.11) - Diese Übersetzung:
-
http://www.bitloeffel.de/DOC/golang/install-source_20180826_de.html
Stand: 29.06.2018
© 2015-18 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 acht Befehlssätze. Die Qualität der Compiler für die verschiedenen Architekturen ist sehr unterschiedlich.
-
amd64
(aliasx86-64
) - Eine ausgereifte Implementierung.
-
386
(aliasx86
oderx86-32
) -
Vergleichbar mit
amd64
, -
arm
(aliasARM
) - Liefert Binärdateien für Linux, FreeBSD, NetBSD, OpenBSD und Darwin; weniger verbreitet als die anderen.
-
arm64
(aliasAArch64
) - Liefert Binärdateien für Linux und Darwin; neu in Go 1.5 und noch nicht so ausgereift wie die anderen.
-
ppc64, ppc64le
(64-bit PowerPC Big- und Little-Endian) - Liefert Binärdateien für Linux; neu in Go 1.5 und noch nicht so ausgereift wie die anderen.
-
mips, mipse
(32-bit MIPS Big- und Little-Endian) - Liefert Binärdateien für Linux; neu in Go 1.8 und noch nicht so ausgereift wie die anderen.
-
mips64, mips64le
(64-bit MIPS Big- und Little-Endian) - Liefert Binärdateien für Linux; neu in Go 1.6 und noch nicht so ausgereift wie die anderen.
-
s390x
(IBM System z) - Liefert Binärdateien für Linux; neu in Go 1.7 und noch nicht so ausgereift wie die anderen.
Abgesehen von systemnahem Kode etwa für Betriebssystemschnittstellen ist das Laufzeitsystem für alle Portierungen gleichwertig; es verfügt über eine automatische Speicherbereinigung mit einem Markier-Fege-Algorithmus (mark-and-sweep), ein effizientes Aufschneiden von Arrays und Strings, sowie über Unterstützung für effiziente Goroutinen, etwa durch Kellerspeicher (stack), der je nach Bedarf wächst oder schrumpft.
Die Compiler können die Betriebssysteme DragonFly BSD, FreeBSD, Linux, NetBSD, OpenBSD, macOS (Darwin), Plan 9, Solaris und Windows zum Ziel haben. 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:
- Linux auf dem 64-Bit-PowerPC wird erst ab der Kernel-Version 2.6.37 unterstützt, d.h. dass Go auf diesen Systemen CentOS 6 nicht unterstützt.
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.
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.
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
.
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.
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, der der übergeordnete werden soll, und stellen Sie sicher, dass dort ein
Ordner go
noch nicht existiert. Dann klonen Sie das Repositorium
und buchen zur letzten Freigabemarke (zum Beispiel go1.9
) aus:
$ git clone https://go.googlesource.com/go $ cd go $ git checkout <Marke>
<Marke>
steht hier für den Version-String der
Freigabe (release).
(Optional) Wechseln Sie in den "master"-Zweig
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 sie alle auf
einmal zu installieren, rufen Sie das Kommando go get
so:
$ go get golang.org/x/tools/cmd/...
Oder, wenn nur ein einzelnes Kommando (in diesem Fall godoc
)
installiert werden soll, so:
$ go get golang.org/x/tools/cmd/godoc
Das Kommando go get
setzt hier das Vorhandensein von
Git voraus.
Außerdem muss ein Arbeitsbereich (GOPATH
) festgelegt sein; genaueres in
"Wie man mit Go arbeitet".
Achtung: Das go
-Kommando installiert die Binärdatei
godoc
nach $GOROOT/bin
(oder $GOBIN
)
und die Binärdateien cover
und vet
nach
$GOROOT/pkg/tool/$GOOS_$GOARCH
. Die beiden letzteren benutzt man mit
"go tool cover
" bzw. "go tool vet
".
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.
$GOROOT
Die Wurzel des Go-Verzeichnisbaums — oft ist das
$HOME/go1.X
. Ihr Wert wird während der Umwandlung festgelegt; Vorgabewert ist der Elternordner zum Ordner aus dem herausall.bash
gestartet wurde. Es gibt keinen Grund diese Variable zu setzen, außer dem, zwischen mehreren lokalen Kopien des Repositoriums hin und her schalten zu können.$GOROOT_FINAL
Der Wert, den installierte Binärdateien und Skripte annehmen, solange
$GOROOT
nicht explizit gesetzt wurde; Vorgabewert ist der Wert von$GOROOT
. Wenn Sie den Go-Verzeichnisbaum an einer Stelle bauen, danach aber woanders hin verschieben wollen, so setzen Sie als$GOROOT_FINAL
den entsprechenden Pfad.$GOOS
und$GOARCH
Der Name des Zielsystems sowie dessen Architektur. Vorgabe sind die Werte von
$GOHOSTOS
bzw.$GOHOSTARCH
, die weiter unten beschrieben sind.Mögliche Werte für
$GOOS
sinddarwin
(macOS 10.10 und neuer sowie iOS),dragonfly
,freebsd
,linux
,netbsd
,openbsd
,plan9
,solaris
undwindows
. Mögliche Werte für$GOARCH
sindamd64
(64-Bit x86, am weitesten gereift),386
(32-Bit x86),arm
(32-Bit ARM),arm64
(64-Bit ARM),ppc64le
(PowerPC 64-Bit, Little-Endian),ppc64
(PowerPC 64-Bit, Big-Endian),mips64le
(MIPS 64-Bit, Little-Endian),mips64
(MIPS 64-bit, Big-Endian),mipsle
(MIPS 32-Bit, Little-Endian),mips
(MIPS 32-Bit, Big-Endian) unds390x
(IBM System z 64-bit, Big-Endian). Die gültigen Kombinationen von$GOOS
und$GOARCH
sind:$GOOS
$GOARCH
android
arm
darwin
386
darwin
amd64
darwin
arm
darwin
arm64
dragonfly
amd64
freebsd
386
freebsd
amd64
freebsd
arm
linux
386
linux
amd64
linux
arm
linux
arm64
linux
ppc64
linux
ppc64le
linux
mips
linux
mipsle
linux
mips64
linux
mips64le
linux
s390x
netbsd
386
netbsd
amd64
netbsd
arm
openbsd
386
openbsd
amd64
openbsd
arm
plan9
386
plan9
amd64
solaris
amd64
windows
386
windows
amd64
$GOHOSTOS
and$GOHOSTARCH
Der Name des Quellsystems sowie dessen Architektur. Vorgabe sind das Betriebssystem und die Architektur des lokalen Systems.
Mögliche Werte sind diegleichen wie in der Liste oben für
$GOOS
und$GOARCH
. Die angegebenen Werte müssen mit dem lokalen System kompatibel sein; zum Beispiel können Sie auf einem x86-System$GOHOSTARCH
nicht zuarm
setzen.$GOBIN
Der Ordner in dem Go-Binärdateien installiert werden; der Vorgabewert ist
$GOROOT/bin
. Nach der Installation wollen Sie sicher diesen Ordner in Ihrem$PATH
aufnehmen, so dass die Go-Werkzeuge auch benutzt werden können. Wenn$GOBIN
gesetzt ist, installiert das go-Kommando alle Kommandos dort.$GO386
(nur für
386
; Vorgabewert wird automatisch ermittelt, wenn auf386
oderamd64
kompiliert wird, sonst ist er387
).Das legt fest, ob der Kode, der von gc generiert wird, für Gleitkommaoperationen die 387-Gleitkommaeinheit (Wert
387
) oder SSE2-Befehle (Wertsse2
) benutzt.GO386=387
: Benutze x87 für Gleitkommaoperationen; sollte alle x86-Chips (Pentium MMX oder neuer) unterstützen.GO386=sse2
: Benutze SSE2 für Gleitkommaoperationen; ist performanter als 387, aber erst für Pentium 4/Opteron/Athlon 64 oder neuere verfügbar.
$GOARM
(nur für
arm
; Vorgabewert wird automatisch ermittelt, wenn auf dem Zielprozessor kompiliert wird, sonst6
.)Das setzt die Version der ARM-Gleitkomma-Koprozessorarchitektur. Wenn Sie auf dem Zielsystem kompilieren, wird der Wert automatisch ermittelt.
GOARM=5
: Benutze Software-Gleitkommaoperationen; wenn die CPU keinen Gleitkomma-Koprozessor besitztGOARM=6
: Benutze ausschließlich VFPv1; Vorgabe, wenn fremdkompiliert (cross-compiling) wird; üblicherweise ARM11-Kerne oder besser (VFPv2 oder besser wird auch unterstützt)GOARM=7
: Benutze VFPv3; üblicherweise Cortex-A-Kerne
Lassen Sie das im Zweifelsfall unangetastet, und passen Sie erst an, wenn's beim ersten Ausführen der Binärdatei nötig werden sollte. Der Wiki-Artikel zum Stichwort GoARM enthält weitere Details bezüglich Gos ARM-Unterstützung.
$GOMIPS
(nurmips
undmipsle
)Damit legt man fest, ob Gleitkommabefehle benutzt werden.
GOMIPS=hardfloat
: Benutze Gleitkommabefehle (Voreinstellung)GOMIPS=softfloat
: Benutze softwaresimulierte Gleitkommabefehle
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 GOROOT=$HOME/go1.X 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!