Установка

Быстрая установка (5 минут)

TL;DR - для опытных разработчиков

# Установите Go 1.25+, затем:
go install github.com/wailsapp/wails/v3/cmd/wails3@latest
wails3 doctor  # Проверка установки

Если команда wails3 doctor прошла успешно, установка завершена. Перейти к созданию первого приложения →

Пошаговая установка

1. Установка Go (обязательно)

   Для работы Wails требуется Go версии 1.25 или новее.

   Windows

   Скачайте установщик для Windows с go.dev/dl и запустите его.

   Проверка установки:

   go version  # Должна отобразиться версия 1.25 или новее

   Проверка PATH:

   $env:PATH -split ';' | Where-Object { $_ -like '*\go\bin' }

   Если вывод пустой, добавьте C:\Users\YourName\go\bin в переменную PATH.

   macOS

   Вариант 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

   Linux

   Вариант 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

2. Установка зависимостей платформы

   Windows

   WebView2 Runtime (обычно уже установлен)

   Windows 10/11 включает WebView2 по умолчанию. Если он отсутствует:

   • Скачайте его с Microsoft
   • Или выполните wails3 doctor позже — он подскажет, что делать

   На этом всё! Другие зависимости не требуются.

   Совет по производительности для Windows 11

   Рекомендуется использовать Dev Drive для хранения проектов. Диски Dev Drive оптимизированы для задач разработки и могут значительно ускорить время сборки и доступ к диску (до 30%).

   macOS

   Инструменты командной строки Xcode (обязательно)

   xcode-select --install

   Нажмите “Install” в появившемся диалоговом окне.

   Проверка:

   xcode-select -p  # Должен отобразиться /Library/Developer/CommandLineTools

   На этом всё! macOS включает WebKit по умолчанию.

   Linux

   Инструменты сборки и WebKit

   Минимальные версии дистрибутивов

   Wails v3 требует WebKitGTK 4.1 (использует libsoup3). Более старые релизы, которые поставляются только с версией 4.0 — Ubuntu 20.04, Debian 11, RHEL 8/9 и их производные — не поддерживаются.

   Ubuntu/Debian

   Требуется Ubuntu 22.04+ или Debian 12+.

   sudo apt update
   sudo apt install build-essential pkg-config libgtk-3-dev libwebkit2gtk-4.1-dev

   Fedora

   sudo dnf install gcc pkg-config gtk3-devel webkit2gtk4.1-devel

   Arch

   sudo pacman -S base-devel gtk3 webkit2gtk-4.1

   openSUSE

   sudo zypper install gcc pkg-config gtk3-devel webkit2gtk3-devel

   Gentoo

   sudo emerge --ask net-libs/webkit-gtk:4.1

   NixOS

   Добавьте в ваш shell.nix или devShell:

   buildInputs = with pkgs; [ webkitgtk_4_1 gtk3 pkg-config gcc ];

   Другие

   Выполните wails3 doctor после установки Wails — он покажет точные пакеты, необходимые для вашего дистрибутива.

   Дополнительно: поддержка GTK4

   Wails также имеет экспериментальную поддержку GTK4 / WebKitGTK 6.0. Если вы хотите собирать приложения с GTK4, установите дополнительные зависимости для вашего дистрибутива и выполните сборку с помощью wails3 build -tags gtk4. Подробности см. в разделе Упаковка для Linux - GTK4.

3. Установка Wails CLI

   go install github.com/wailsapp/wails/v3/cmd/wails3@latest

   Это установит команду wails3 в ~/go/bin (или %USERPROFILE%\go\bin на Windows).

4. Проверка установки

   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   | v3.0.0-alpha.40 |
   | 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!

   Если команда wails3 не найдена

   Ваша директория ~/go/bin не добавлена в PATH. См. шаг 1 выше, чтобы исправить это, затем перезапустите терминал.

5. Установка npm (необязательно, но рекомендуется)

   Большинство шаблонов Wails используют npm для фронтенд-инструментов.

   Windows

   Скачайте с nodejs.org и запустите установщик.

   Проверка:

   npm --version

   macOS

   Вариант 1: Официальный установщик Скачайте с nodejs.org

   Вариант 2: Homebrew

   brew install node

   Проверка:

   npm --version

   Linux

   Вариант 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

   Альтернативные менеджеры пакетов

   Предпочитаете pnpm, yarn или bun? Без проблем! Просто обновите Taskfile.yml в вашем проекте для использования предпочтительного инструмента.

Устранение неполадок

Команда wails3 не найдена

Причина: ~/go/bin (или %USERPROFILE%\go\bin на Windows) не добавлен в PATH.

Решение:

Windows

1. Откройте «Переменные среды» (поиск в меню Пуск)
2. В разделе «Переменные пользователя» найдите Path
3. Нажмите «Изменить» → «Создать»
4. Добавьте: C:\Users\ВашеИмя\go\bin (замените ВашеИмя)
5. Нажмите «ОК» во всех диалогах
6. Перезапустите терминал

Проверка:

$env:PATH -split ';' | Where-Object { $_ -like '*\go\bin' }

macOS/Linux

Добавьте в ~/.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-dev

Windows: Если WebView2 отсутствует:

• Скачайте с Microsoft
• Или будет установлен автоматически при первом запуске приложения

macOS: Если инструменты Xcode отсутствуют:

xcode-select --install

---

Версия Go слишком старая

Wails v3 требует Go 1.25+. Если у вас более старая версия:

Windows/macOS

Загрузите последнюю версию с go.dev/dl и переустановите.

Linux

Загрузите последний архив 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

Версия для разработчиков

• Может содержать ошибки или ломающие изменения
• Проекты, созданные с её помощью, будут использовать директиву replace для указания на локальный Wails
• Рекомендуется только для участников разработки или тестирования новых функций

Следующие шаги

Установка завершена! Ваша система готова к разработке на Wails.

Создайте своё первое приложение

Создайте рабочее приложение за 10 минут.

Руководство по первому приложению →

Изучите шаблоны

Посмотрите, что доступно из коробки.

wails3 init -l  # Список шаблонов

---

Возникли проблемы? Задайте вопрос в Discord или откройте issue.