Getting Started — Deutsche Übersetzung
- Das Original:
-
http://golang.org/doc/install.html
Version of August 6, 2016 (Go 1.7) - Diese Übersetzung:
-
http://www.bitloeffel.de/DOC/golang/install_20160815_de.html
Stand: 15.8.2016
© 2015-16 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.
Anfangen
Besorgen der Go-Distribution
Download Go Click here to visit the downloads page
Offizielle
Binärdistributionen
gibt es für die Betriebssysteme FreeBSD (Release 8-STABLE und höher), Linux,
Mac OS X (10.8 und höher) und Windows, sowie die x86
Prozessorarchitektur in den Varianten 32-Bit (386
)
und 64-Bit (amd64
).
Wenn es für Ihre Kombination aus Betriebssystem und Architektur keine Binärdistribution gibt, probieren Sie es mit "Installing Go from source" ("Go installieren (aus dem Quellkode)") oder "Setting up and using gccgo".
Systemvoraussetzungen
Go-Binärdistributionen gibt es für folgende unterstützten Betriebssysteme und Architekturen. Bevor Sie weitermachen, stellen Sie bitte fest, ob Ihr System diesen Anforderungen genügt. Wenn Ihr Betriebssystem oder Ihre Architektur nicht in der Liste stehen, können Sie eventuell vom Quellkode aus installieren oder stattdessen gccgo benutzen.
Betriebssystem | Architektur | Bemerkungen |
---|---|---|
FreeBSD 8-STABLE oder neuer | amd64 | Debian GNU/kFreeBSD nicht unterstützt |
Linux 2.6.23 oder neuer mit glibc | amd64, 386, arm | CentOS/RHEL 5.x nicht unterstützt |
Mac OS X 10.7 oder neuer | amd64 | Benutzen Sie clang oder gcc† (Teil von Xcode‡) zur Unterstützung von cgo |
Windows XP oder neuer | amd64, 386 | Benutzen Sie MinGW gcc†. Cygwin or msys werden nicht gebraucht. |
†gcc
wird nur gebraucht, wenn Sie
cgo einsetzen wollen.
‡Sie brauchen von
Xcode nur die "command line tools"
zu installieren. Wenn Sie Xcode 4.3+ schon installiert haben, installieren Sie über
"Downloads"-"Preferences"-"Components".
Installieren der Go-Werkzeuge
Wenn Sie eine ältere Go-Version aufrüsten wollen, müssen Sie diese zuerst entfernen.
Tar-Archive für Linux, Mac OS X und FreeBSD
Besorgen Sie das Archiv
und entpacken Sie es nach /usr/local
, wobei ein
Go-Verzeichnisbaum in /usr/local/go
entsteht. Etwa so:
tar -C /usr/local -xzf go$VERSION.$OS-$ARCH.tar.gz
Wählen Sie das für Ihre Installation geeignete Archiv. Wenn Sie beispielsweise
die Go-Version 1.2.1 für x86, 64-Bit und Linux installieren, so heißt das
entsprechende Archiv go1.2.1.linux-amd64.tar.gz
.
(Typischerweise müssen die Kommandos als root oder über sudo
ausgeführt werden.)
Ergänzen Sie Ihre Umgebungsvariable PATH
mit
/usr/local/go/bin
. Das geht mit einer zusätzlichen Zeile in der
Datei /etc/profile
(für eine systemweite Installation) oder in
$HOME/.profile
:
export PATH=$PATH:/usr/local/go/bin
Lokal installieren
Die Go-Binärdistribution erwartet, in /usr/local/go
(oder c:\Go
unter Windows) installiert zu werden, doch
ist das auch woanders möglich. In so einem Fall müssen Sie die Umgebungsvariable
GOROOT
so setzen, dass sie auf den Ordner zeigt, in dem Go
installiert wurde.
Wenn Sie zum Beispiel Go in Ihrem Home-Verzeichnis installiert haben, dann
fügen Sie folgende Zeilen zu $HOME/.profile
hinzu:
export GOROOT=$HOME/go export PATH=$PATH:$GOROOT/bin
Beachten Sie: GOROOT
muss nur für eine lokale
Installation gesetzt werden.
Mac OS X Paket-Installation
Um die Go-Werkzeuge zu installieren,
besorgen Sie hier die Paketdatei, öffnen Sie
sie, und befolgen Sie die erscheinenden Anweisungen. Die Go-Distribution wird in
/usr/local/go
installiert.
Auch sollte automatisch /usr/local/go/bin
an Ihre Umgebungsvariable
PATH
angehängt werden; damit das wirksam wird, werden Sie eventuell
offene Terminal-Sitzungen neu starten müssen.
Windows
Für Windows bietet das Go-Projekt zwei Installationsoptionen an (abgesehen von der Quellkodeinstallation): ein Zip-Archiv — hier müssen Sie Umgebungsvariablen selbst setzen — und eine MSI-Installation, welche automatisch konfiguriert.
MSI-Installation
Öffnen Sie die MSI-Datei,
und befolgen Sie die erscheinenden Anweisungen. Die Go-Distribution wird in
c:\Go
(Voreinstellung) installiert.
Auch sollte automatisch c:\Go\bin
an Ihre Umgebungsvariable
PATH
angehängt werden; damit das wirksam wird, werden Sie eventuell
offene Kommando-Konsolen neu starten müssen.
Zip-Archiv
Besorgen Sie hier die Zip-Datei und
extrahieren Sie den Inhalt in einen Ordner Ihrer Wahl
(wir schlagen vor: c:\Go
).
Falls Sie einen anderen Ordner als c:\Go
wählen, müssen Sie die
Umgebungsvariable GOROOT
entsprechend setzen.
Hängen Sie dann den bin
-Unterordner Ihres Go-Wurzelordners
(zum Beispiel c:\Go\bin
) an Ihre Umgebungsvariable PATH
.
Umgebungsvariablen setzen in Windows
In Windows ist es möglich, Umgebungsvariablen zu setzen über: Kontrollfenster "System" - Reiter "Advanced" - Schaltfläche "Environment Variables". Bei einigen Windows-Versionen ist das stattdessen: Kontrollfenster "System" - Option "Advanced System Settings".
Die Installation testen
Prüfen Sie die Korrektheit der Installation, indem Sie eine Arbeitsumgebung [enlisch: workspace, A.d.Ü.] einrichten und ein einfaches Programm umwandeln wie folgt.
Erzeugen Sie ein Verzeichnis für Ihre
Arbeitsumgebung
(de)
zum Beispiel $HOME/work
(für Windows C:\work
),
und setzen Sie die Umgebungsvariable GOPATH
so, dass sie dorthin zeigt:
$ export GOPATH=$HOME/work
bzw. für Windows:
C:\> set GOPATH=C:\work
Das obige Kommando sollten sie im Startskript Ihrer Shell unterbringen
(z.B. in $HOME/.profile
). Für Windows befolgen Sie die
Anweisungen oben,
um auf Ihrem System die Umgebungsvariable GOPATH
zu setzen.
Als nächstes legen Sie in Ihrer Arbeitsumgebung das Unterverzeichnis
src/github.com/user/hello
an.
(Wenn Sie GitHub nutzen, ersetzen Sie user
durch Ihren
Benutzernamen.)
Erzeugen Sie dann innerhalb des hello
-Verzeichnisses
eine Datei mit Namen hello.go
mit folgendem Inhalt:
package main import "fmt" func main() { fmt.Printf("Hallo Welt\n") }
Kompilieren Sie das Programm mit dem Kommando go
:
$ go install github.com/user/hello
bzw. für Windows:
C:\> go install github.com/user/hello
Das obige Kommando legt eine ausführbare Binärdatei namens
hello
(oder hello.exe
) im
bin
-Verzeichnis Ihres Arbeitsbereichs ab.
Starten Sie das Programm, um begrüßt zu werden:
$ $GOPATH/bin/hello Hallo Welt
bzw. für Windows:
C:\> %GOPATH%\bin\hello Hallo Welt
Wenn die Nachricht "Hallo Welt" zu sehen ist, dann funktioniert Ihre Go-Installation.
Bevor Sie jetzt davon eilen, um mit Go zu arbeiten, bitte lesen Sie zuerst "How to Write Go Code" [deutsch: "Wie man mit Go arbeitet", A.d.Ü.]; dort wird wesentlich beschrieben, wie man mit den Werkzeugen von Go arbeitet.
Deinstallieren
Um eine bereits eingerichtetes Go von Ihrem System zu entfernen, löschen Sie
den Ordner go
. Das ist üblicherweise /usr/local/go
unter Linux, Mac OS X und FreeBSD, oder c:\Go
unter Windows.
Sie sollten außerdem den Verweis auf das Go-bin
-Verzeichnis aus Ihrer
PATH
-Umgebungsvariablen entfernen. Unter Linux und FreeBSD editieren
Sie dazu /etc/profile
oder $HOME/.profile
.
Hatten Sie Go mit einem Mac-OS-X-Paket installiert, dann
sollten Sie die Datei /etc/paths.d/go
entfernen.
Windows-Benutzer lesen bitte noch einmal den Abschnitt
"Umgebungsvariablen setzen in Windows".
Hilfe
Hilfe in Echtzeit erhalten Sie, wenn Sie die hilfsbereiten Ziesel bei
#go-nuts
auf dem
Freenode-IRC-Server fragen.
Die offizielle Verteilerliste für Diskussionen zur Sprache Go ist Go Nuts.
Fehler melden Sie bitte über das Go-Fallbearbeitungssystem.