Установка
Установите Wails и подготовьте среду для создания приложений
Быстрая установка (5 минут)
Пошаговая установка
Установите Go (обязательно)
Для Wails требуется Go версии 1.25 или новее.
Скачайте установщик для Windows с сайта go.dev/dl и запустите его.
Проверьте установку:
go version # Should show 1.25 or later
Проверьте 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 # Should show 1.25 or later
echo $PATH | grep go/bin # Should show ~/go/bin
Если ~/go/bin отсутствует в PATH, добавьте его в ~/.zshrc или ~/.bash_profile:
export PATH=$PATH:~/go/bin
Вариант 1: официальный tar-архив
Скачайте tar-архив для 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 # Reload
Проверьте:
go version
echo $PATH | grep go/bin
Установите зависимости для платформы
Среда выполнения WebView2 (обычно уже установлена)
В Windows 10/11 WebView2 включён по умолчанию. Если он отсутствует:
- Скачайте с сайта Microsoft
- Или запустите
wails3 doctorпозже — программа подскажет, что делать
Готово! Другие зависимости не требуются.
Инструменты командной строки Xcode (обязательно)
xcode-select --install
В появившемся диалоговом окне нажмите «Установить».
Проверьте:
xcode-select -p # Should show /Library/Developer/CommandLineTools
Готово! В macOS WebKit включён по умолчанию.
Инструменты сборки и WebKit
Для стандартного стека GTK4 требуется Ubuntu 24.04+ или Debian 13+.
sudo apt update
sudo apt install build-essential pkg-config libgtk-4-dev libwebkitgtk-6.0-dev
sudo dnf install gcc pkg-config gtk4-devel webkitgtk6.0-devel
sudo pacman -S base-devel gtk4 webkitgtk-6.0
sudo zypper install gcc pkg-config gtk4-devel webkitgtk-6_0-devel
sudo emerge --ask net-libs/webkit-gtk:6
Добавьте в shell.nix или devShell:
buildInputs = with pkgs; [ webkitgtk_6_0 gtk4 pkg-config gcc ];После установки Wails запустите wails3 doctor — команда покажет точные пакеты, необходимые для вашего дистрибутива.
Установите CLI Wails
go install github.com/wailsapp/wails/v3/cmd/wails3@latest
Команда wails3 будет установлена в ~/go/bin (или в %USERPROFILE%\go\bin в Windows).
Запустите мастер настройки (рекомендуется)
wails3 setup
Мастер настройки проверит зависимости, поможет установить отсутствующие и настроит параметры проекта по умолчанию.
Проверьте установку
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 | Your installed version |
| Go Version | go1.25.0 |
└─────────────┴─────────────────┘
# 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) отсутствует в PATH.
Решение:
- Откройте «Переменные среды» (найдите их через меню «Пуск»)
- В разделе «Переменные среды пользователя» найдите
Path - Нажмите «Изменить» → «Создать»
- Добавьте:
C:\Users\YourName\go\bin(заменитеYourName) - Нажмите «ОК» во всех диалоговых окнах
- Перезапустите терминал
Проверка:
$env:PATH -split ';' | Where-Object { $_ -like '*\go\bin' }
Добавьте в ~/.zshrc (macOS) или ~/.bashrc (Linux):
export PATH=$PATH:~/go/bin
Перезагрузите конфигурацию:
source ~/.zshrc # or ~/.bashrc
Проверка:
echo $PATH | grep go/bin
wails3 version
wails3 doctor сообщает об отсутствующих зависимостях
Linux: в выводе точно указано, какие пакеты нужно установить. Пример:
❌ webkit2gtk not found
Install with: sudo apt install libwebkit2gtk-4.1-devWindows: если отсутствует WebView2:
- Скачайте с сайта Microsoft
- Или он будет установлен автоматически при запуске первого приложения
macOS: если отсутствуют инструменты Xcode:
xcode-select --install
Слишком старая версия Go
Для Wails v3 требуется Go 1.25+. Если у вас установлена более старая версия:
Скачайте последнюю версию с go.dev/dl и переустановите Go.
Скачайте последний tar-архив с go.dev/dl, затем выполните:
sudo rm -rf /usr/local/go
sudo tar -C /usr/local -xzf go1.25.linux-amd64.tar.gz
Версия для разработки (самая свежая)
Хотите использовать самый свежий код из основной ветки разработки? Вы получите доступ к новым возможностям и исправлениям до их выпуска, но при этом существует риск ошибок и несовместимых изменений. Рекомендуется только участникам проекта и тем, кому нужно тестировать будущие возможности.
git clone https://github.com/wailsapp/wails.git
cd wails
git checkout v3
cd v3/cmd/wails3
go install
Следующие шаги
Установка завершена! Ваша система готова к разработке с Wails.
Создайте работающее приложение за 10 минут.
Посмотрите, что доступно сразу после установки.
wails3 init -l # List templates
Возникли проблемы? Спросите в Discord или создайте обращение.