Установка
Быстрая установка (5 минут)
Пошаговая установка
Установка Go (обязательно)
Для работы Wails требуется Go версии 1.25 или новее.
Скачайте установщик для Windows с go.dev/dl и запустите его.
Проверка установки:
go version # Должна отобразиться версия 1.25 или новее
Проверка PATH:
$env:PATH -split ';' | Where-Object { $_ -like '*\go\bin' }
Если вывод пустой, добавьте C:\Users\YourName\go\bin в переменную PATH.
Вариант 1: Официальный установщик
Скачайте установщик для macOS (файл .pkg) с go.dev/dl и запустите его.
Вариант 2: Homebrew
brew install go
Проверка установки:
go version # Должна отобразиться версия 1.25 или новее
echo $PATH | grep go/bin # Должен отобразиться ~/go/bin
Если ~/go/bin отсутствует в PATH, добавьте его в ~/.zshrc или ~/.bash_profile:
export PATH=$PATH:~/go/bin
Вариант 1: Официальный архив (Tarball)
Скачайте архив для Linux с go.dev/dl, затем выполните:
sudo rm -rf /usr/local/go
sudo tar -C /usr/local -xzf go1.25.linux-amd64.tar.gz
Вариант 2: Менеджер пакетов
# Ubuntu/Debian
sudo apt install golang-go
# Fedora
sudo dnf install golang
# Arch
sudo pacman -S go
Добавление в PATH (добавьте в ~/.bashrc или ~/.zshrc):
export PATH=$PATH:/usr/local/go/bin:~/go/bin
source ~/.bashrc # Перезагрузка конфигурации
Проверка:
go version
echo $PATH | grep go/bin
Установка зависимостей платформы
WebView2 Runtime (обычно уже установлен)
Windows 10/11 включает WebView2 по умолчанию. Если он отсутствует:
- Скачайте его с [Microsoft](https://developer.microsoft.com/microsoft-edge/webview2/)
- Или выполните `wails3 doctor` позже — он подскажет, что делать
**На этом всё!** Другие зависимости не требуются.
Инструменты командной строки Xcode (обязательно)
xcode-select --install
Нажмите “Install” в появившемся диалоговом окне.
Проверка:
xcode-select -p # Должен отобразиться /Library/Developer/CommandLineTools
На этом всё! macOS включает WebKit по умолчанию.
Инструменты сборки и WebKit
Требуется Ubuntu 22.04+ или 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
Добавьте в ваш shell.nix или devShell:
buildInputs = with pkgs; [ webkitgtk_4_1 gtk3 pkg-config gcc ];Выполните wails3 doctor после установки Wails — он покажет точные пакеты, необходимые для вашего дистрибутива.
Установка Wails CLI
go install github.com/wailsapp/wails/v3/cmd/wails3@latest
Это установит команду wails3 в ~/go/bin (или %USERPROFILE%\go\bin на Windows).
Проверка установки
wails3 doctor
Ожидаемый вывод (или похожий):
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 | Установленная версия |
| 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 (необязательно, но рекомендуется)
Большинство шаблонов Wails используют npm для фронтенд-инструментов.
Вариант 1: Официальный установщик Скачайте с nodejs.org
Вариант 2: Homebrew
brew install node
Проверка:
npm --version
Вариант 1: NodeSource
curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo -E bash -
sudo apt-get install -y nodejs # Ubuntu/Debian
Вариант 2: Менеджер пакетов
sudo dnf install nodejs # Fedora
sudo pacman -S nodejs npm # Arch
Проверка:
npm --version
Устранение неполадок
Команда wails3 не найдена
Причина: ~/go/bin (или %USERPROFILE%\go\bin на Windows) не добавлен в PATH.
Решение:
- Откройте «Переменные среды» (поиск в меню Пуск)
- В разделе «Переменные пользователя» найдите
Path - Нажмите «Изменить» → «Создать»
- Добавьте:
C:\Users\ВашеИмя\go\bin(замените ВашеИмя) - Нажмите «ОК» во всех диалогах
- Перезапустите терминал
Проверка:
$env:PATH -split ';' | Where-Object { $_ -like '*\go\bin' }
Добавьте в ~/.zshrc (macOS) или ~/.bashrc (Linux):
export PATH=$PATH:~/go/bin
Перезагрузите:
source ~/.zshrc # или ~/.bashrc
Проверка:
echo $PATH | grep go/bin
wails3 version
wails3 doctor сообщает об отсутствующих зависимостях
Linux: Вывод показывает точно, какие пакеты нужно установить. Пример:
❌ webkit2gtk не найден
Установите: sudo apt install libwebkit2gtk-4.1-devWindows: Если WebView2 отсутствует:
- Скачайте с Microsoft
- Или будет установлен автоматически при первом запуске приложения
macOS: Если инструменты Xcode отсутствуют:
xcode-select --install
Версия Go слишком старая
Wails v3 требует Go 1.25+. Если у вас более старая версия:
Загрузите последнюю версию с go.dev/dl и переустановите.
Загрузите последний архив tarball с go.dev/dl, затем:
sudo rm -rf /usr/local/go
sudo tar -C /usr/local -xzf go1.25.linux-amd64.tar.gz
Версия для разработчиков (Bleeding Edge)
Хотите использовать абсолютно последний код из основной ветки разработки? Это даст вам доступ к новым функциям и исправлениям до их официального выпуска, но сопряжено с риском наличия ошибок и ломающих изменений. Рекомендуется только для участников разработки или тех, кому необходимо тестировать предстоящие функции.
git clone https://github.com/wailsapp/wails.git
cd wails
git checkout v3
cd v3/cmd/wails3
go install
Следующие шаги
Установка завершена! Ваша система готова к разработке на Wails.
Создайте рабочее приложение за 10 минут.
Посмотрите, что доступно из коробки.
wails3 init -l # Список шаблонов
Возникли проблемы? Задайте вопрос в Discord или откройте issue.