インストール
Wails をインストールし、アプリケーションをビルドできる状態にします
クイックインストール（5 分）
ステップごとのインストール手順
Go のインストール（必須）
Wails には Go 1.25 以降が必要です。
go.dev/dl から Windows インストーラーをダウンロードして実行します。
インストールを確認：
go version # Should show 1.25 or later
PATH を確認：
$env:PATH -split ';' | Where-Object { $_ -like '*\go\bin' }
空の場合は、C:\Users\YourName\go\bin を PATH に追加します。
方法 1：公式インストーラー
go.dev/dl から macOS インストーラー（.pkg ファイル）をダウンロードして実行します。
方法 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：公式 tarball
go.dev/dl から Linux の tarball をダウンロードし、次を実行します：
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 Runtime（通常はプリインストール済み）
Windows 10/11 には、WebView2 が標準で含まれています。含まれていない場合：
- Microsoft からダウンロードします
- または、後で
wails3 doctorを実行します。手順が案内されます
これで完了です！ ほかの依存関係は必要ありません。
Xcode Command Line Tools（必須）
xcode-select --install
表示されたダイアログで「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 を実行します。使用しているディストリビューションに必要なパッケージが正確に表示されます。
Wails CLI のインストール
go install github.com/wailsapp/wails/v3/cmd/wails3@latest
これにより、wails3 コマンドが ~/go/bin（Windows では %USERPROFILE%\go\bin）にインストールされます。
セットアップウィザードの実行（推奨）
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は置き換えてください）- すべてのダイアログで「OK」をクリックします
- ターミナルを再起動します
確認：
$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.dev/dl から最新の tarball をダウンロードし、次の操作を行います：
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