インストール

クイックインストール（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

   go.dev/dl からWindowsインストーラーをダウンロードして実行してください。

   インストールの確認:

   go version  # 1.25以降が表示されるはずです

   PATHの確認:

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

   空の場合、C:\Users\YourName\go\binをPATHに追加してください。

   macOS

   オプション1: 公式インストーラー

   go.dev/dl からmacOSインストーラー（.pkgファイル）をダウンロードして実行してください。

   オプション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: 公式タールボール

   go.dev/dl からLinux用タールボールをダウンロードし、その後:

   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ランタイム（通常はプリインストール済み）

   Windows 10/11にはWebView2がデフォルトで含まれています。不足している場合:

   • Microsoft からダウンロード
   • または後で wails3 doctor を実行してください。ガイドが表示されます

   これで完了です！ 他の依存関係は必要ありません。

   Windows 11のパフォーマンスヒント

   プロジェクトの保存にDev Driveの使用を検討してください。Dev Driveは開発者ワークロード向けに最適化されており、ビルド時間とディスクアクセス速度を最大30%改善できます。

   macOS

   Xcodeコマンドラインツール（必須）

   xcode-select --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 ];

   その他

   Wailsインストール後、wails3 doctorを実行してください。ディストロに必要な正確なパッケージが表示されます。

   オプション: 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（Windowsの場合は%USERPROFILE%\go\bin）にインストールされます。

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（Windowsの場合は%USERPROFILE%\go\bin）がPATHに含まれていません。

解決策：

Windows

1. 「環境変数」を開く（スタートメニューで検索）
2. 「ユーザー変数」のPathを見つける
3. 「編集」→「新規」をクリック
4. 追加：C:\Users\YourName\go\bin（YourNameを置き換える）
5. すべてのダイアログで「OK」をクリック
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

go.dev/dl から最新の tarball をダウンロードし、その後:

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 を指すために replace ディレクティブを使用します
• コントリビューターや新機能のテストにのみ推奨されます

次のステップ

インストール完了！ システムは Wails 開発の準備が整いました。

最初のアプリをビルド

10分で動作するアプリケーションを作成します。

最初のアプリチュートリアル →

テンプレートを探検

デフォルトで利用可能なものをご覧ください。

wails3 init -l  # テンプレートをリスト

---

問題が発生しましたか？ Discord で質問するか、issue を開く してください。