Installation
Schnellinstallation (5 Minuten)
Schritt-für-Schritt-Installation
Go installieren (Erforderlich)
Wails erfordert Go 1.25 oder höher.
Laden Sie den Windows-Installer von go.dev/dl herunter und führen Sie ihn aus.
Installation überprüfen:
go version # Sollte 1.25 oder höher anzeigen
PATH überprüfen:
$env:PATH -split ';' | Where-Object { $_ -like '*\go\bin' }
Wenn die Ausgabe leer ist, fügen Sie C:\Users\IhrName\go\bin zu Ihrem PATH hinzu.
Option 1: Offizieller Installer
Laden Sie den macOS-Installer (.pkg-Datei) von go.dev/dl herunter und führen Sie ihn aus.
Option 2: Homebrew
brew install go
Installation überprüfen:
go version # Sollte 1.25 oder höher anzeigen
echo $PATH | grep go/bin # Sollte ~/go/bin anzeigen
Wenn ~/go/bin nicht im PATH enthalten ist, fügen Sie es zu ~/.zshrc oder ~/.bash_profile hinzu:
export PATH=$PATH:~/go/bin
Option 1: Offizielles Tarball
Laden Sie das Linux-Tarball von go.dev/dl herunter, dann:
sudo rm -rf /usr/local/go
sudo tar -C /usr/local -xzf go1.25.linux-amd64.tar.gz
Option 2: Paketmanager
# Ubuntu/Debian
sudo apt install golang-go
# Fedora
sudo dnf install golang
# Arch
sudo pacman -S go
Zum PATH hinzufügen (fügen Sie dies zu ~/.bashrc oder ~/.zshrc hinzu):
export PATH=$PATH:/usr/local/go/bin:~/go/bin
source ~/.bashrc # Neu laden
Überprüfen:
go version
echo $PATH | grep go/bin
Plattformabhängigkeiten installieren
WebView2-Laufzeitumgebung (normalerweise vorinstalliert)
Windows 10/11 enthält WebView2 standardmäßig. Falls fehlend:
- Von [Microsoft](https://developer.microsoft.com/microsoft-edge/webview2/) herunterladen
- Oder führen Sie später `wails3 doctor` aus – es wird Sie anleiten
**Das war's!** Keine weiteren Abhängigkeiten erforderlich.
Xcode Command Line Tools (erforderlich)
xcode-select --install
Klicken Sie im erscheinenden Dialogfeld auf “Installieren”.
Überprüfen:
xcode-select -p # Sollte /Library/Developer/CommandLineTools anzeigen
Das war’s! macOS enthält WebKit standardmäßig.
Build-Tools und WebKit
Erfordert Ubuntu 22.04+ oder Debian 12+.
sudo apt update
sudo apt install build-essential pkg-config libgtk-3-dev libwebkit2gtk-4.1-dev
sudo dnf install gcc pkg-config gtk3-devel webkit2gtk4.1-devel
sudo pacman -S base-devel gtk3 webkit2gtk-4.1
sudo zypper install gcc pkg-config gtk3-devel webkit2gtk3-devel
sudo emerge --ask net-libs/webkit-gtk:4.1
Fügen Sie dies zu Ihrer shell.nix oder devShell hinzu:
buildInputs = with pkgs; [ webkitgtk_4_1 gtk3 pkg-config gcc ];Führen Sie nach der Installation von Wails wails3 doctor aus – es zeigt die genauen Pakete an, die für Ihre Distribution benötigt werden.
Wails CLI installieren
go install github.com/wailsapp/wails/v3/cmd/wails3@latest
Dies installiert den Befehl wails3 nach ~/go/bin (oder %USERPROFILE%\go\bin unter Windows).
Installation überprüfen
wails3 doctor
Erwartete Ausgabe (oder ähnlich):
Wails (v3.0.0-dev) Wails Doctor
# System
┌──────────────────────────────────────────────────┐
| Name | MacOS |
| Version | 26.0 |
| ID | 25A354 |
| Branding | MacOS 26.0 |
| Platform | darwin |
| Architecture | arm64 |
| Apple Silicon | true |
| CPU | Apple M2 Pro |
| CPU 1 | Apple M2 Pro |
| CPU 2 | Apple M2 Pro |
| GPU | 16 cores, Metal Support: Metal 4 |
| Memory | 16 GB |
└──────────────────────────────────────────────────┘
# Build Environment
┌─────────────┬─────────────────┐
| Wails CLI | Ihre installierte Version |
| Go Version | go1.24.6 |
└─────────────┴─────────────────┘
# Dependencies
┌─────────────────┬─────────────────────────────────────────────────┐
| npm | 11.6.2 |
| *NSIS | Not Installed. Install with `brew install...`. |
| Xcode cli tools | 2412 |
└─────────────────┴─────────────────────────────────────────────────┘
# Checking for issues
SUCCESS No issues found
# Diagnosis
SUCCESS Your system is ready for Wails development!npm installieren (Optional, aber empfohlen)
Die meisten Wails-Vorlagen verwenden npm für die Frontend-Tooling.
Laden Sie es von nodejs.org herunter und führen Sie den Installer aus.
Überprüfen:
npm --version
Option 1: Offizieller Installer Von nodejs.org herunterladen
Option 2: Homebrew
brew install node
Überprüfen:
npm --version
Option 1: NodeSource
curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo -E bash -
sudo apt-get install -y nodejs # Ubuntu/Debian
Option 2: Paketmanager
sudo dnf install nodejs # Fedora
sudo pacman -S nodejs npm # Arch
Überprüfen:
npm --version
Fehlerbehebung
wails3-Befehl nicht gefunden
Ursache: ~/go/bin (oder %USERPROFILE%\go\bin) ist nicht in Ihrem PATH enthalten.
Lösung:
- Öffnen Sie “Umgebungsvariablen” (in der Startsuche suchen)
- Unter “Benutzervariablen” den Eintrag
Pathfinden - Klicken Sie auf “Bearbeiten” → “Neu”
- Hinzufügen:
C:\Users\IhrName\go\bin(ersetzen Sie IhrName) - Klicken Sie auf allen Dialogen auf “OK”
- Terminal neu starten
Überprüfen:
$env:PATH -split ';' | Where-Object { $_ -like '*\go\bin' }
Fügen Sie zu ~/.zshrc (macOS) oder ~/.bashrc (Linux) hinzu:
export PATH=$PATH:~/go/bin
Neu laden:
source ~/.zshrc # oder ~/.bashrc
Überprüfen:
echo $PATH | grep go/bin
wails3 version
wails3 doctor meldet fehlende Abhängigkeiten
Linux: Die Ausgabe zeigt genau an, welche Pakete installiert werden sollen. Beispiel:
❌ webkit2gtk nicht gefunden
Installation mit: sudo apt install libwebkit2gtk-4.1-devWindows: Falls WebView2 fehlt:
- Von Microsoft herunterladen
- Oder es wird automatisch installiert, wenn Sie Ihre erste App ausführen
macOS: Falls Xcode-Tools fehlen:
xcode-select --install
Go-Version zu alt
Wails v3 erfordert Go 1.25+. Wenn Sie eine ältere Version haben:
Laden Sie die neueste Version von go.dev/dl herunter und installieren Sie sie erneut.
Laden Sie die neueste Tarball-Datei von go.dev/dl herunter, dann:
sudo rm -rf /usr/local/go
sudo tar -C /usr/local -xzf go1.25.linux-amd64.tar.gz
Entwicklungsversion (Bleeding Edge)
Möchten Sie den absolut neuesten Code aus dem Hauptentwicklungsbranch verwenden? Dies gibt Ihnen Zugang zu neuen Funktionen und Fehlerbehebungen, bevor sie veröffentlicht werden, bringt jedoch das Risiko von Bugs und Breaking Changes mit sich. Nur für Mitwirkende oder diejenigen empfohlen, die kommende Funktionen testen müssen.
git clone https://github.com/wailsapp/wails.git
cd wails
git checkout v3
cd v3/cmd/wails3
go install
Nächste Schritte
Installation abgeschlossen! Ihr System ist bereit für die Wails-Entwicklung.
Erstellen Sie in 10 Minuten eine funktionierende Anwendung.
Sehen Sie, was standardmäßig verfügbar ist.
wails3 init -l # Vorlagen auflisten
Haben Sie Probleme? Fragen Sie in Discord oder öffnen Sie ein Issue.