インストール

クイックインストール（5分）

bash

# Go 1.25以降をインストールし、その後:
go install github.com/wailsapp/wails/v3/cmd/wails3@latest
wails3 doctor  # インストールの確認

wails3 doctorが成功すれば完了です。最初のアプリへスキップ →

ステップバイステップのインストール

Goのインストール（必須）

WailsにはGo 1.25以降が必要です。

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

インストールの確認:

PowerShell

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

PATHの確認:

PowerShell

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

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

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

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

オプション2: Homebrew

bash

brew install go

インストールの確認:

bash

go version  # 1.25以降が表示されるはずです
echo $PATH | grep go/bin  # ~/go/binが表示されるはずです

~/go/binがPATHに含まれていない場合は、~/.zshrcまたは~/.bash_profileに追加してください:

bash

export PATH=$PATH:~/go/bin

オプション1: 公式タールボール

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

bash

sudo rm -rf /usr/local/go
sudo tar -C /usr/local -xzf go1.25.linux-amd64.tar.gz

オプション2: パッケージマネージャー

bash

# Ubuntu/Debian
sudo apt install golang-go

# Fedora
sudo dnf install golang

# Arch
sudo pacman -S go

PATHに追加（~/.bashrcまたは~/.zshrcに追加）:

bash

export PATH=$PATH:/usr/local/go/bin:~/go/bin
source ~/.bashrc  # 再読み込み

確認:

bash

go version
echo $PATH | grep go/bin

プラットフォーム依存関係のインストール

WebView2ランタイム（通常はプリインストール済み）

Windows 10/11にはWebView2がデフォルトで含まれています。不足している場合:
- [Microsoft](https://developer.microsoft.com/microsoft-edge/webview2/) からダウンロード
- または後で `wails3 doctor` を実行してください。ガイドが表示されます

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

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

bash

xcode-select --install

表示されるダイアログで「インストール」をクリックしてください。

確認:

bash

xcode-select -p  # /Library/Developer/CommandLineToolsが表示されるはずです

これで完了です！ macOSにはWebKitがデフォルトで含まれています。

ビルドツールとWebKit

Ubuntu 22.04以降またはDebian 12以降が必要です。

bash

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

bash

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

bash

sudo pacman -S base-devel gtk3 webkit2gtk-4.1

bash

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

bash

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

shell.nixまたはdevShellに追加してください:

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

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

Wails CLIのインストール

bash

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

これにより、wails3コマンドが~/go/bin（Windowsの場合は%USERPROFILE%\go\bin）にインストールされます。

インストールの確認

bash

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を使用しています。

nodejs.org からダウンロードしてインストーラーを実行してください。

確認:

PowerShell

npm --version

オプション1: 公式インストーラー nodejs.org からダウンロード

オプション2: Homebrew

bash

brew install node

確認:

bash

npm --version

オプション1: NodeSource

bash

curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo -E bash -
sudo apt-get install -y nodejs  # Ubuntu/Debian

オプション2: パッケージマネージャー

bash

sudo dnf install nodejs  # Fedora
sudo pacman -S nodejs npm  # Arch

確認:

bash

npm --version

トラブルシューティング

`wails3`コマンドが見つからない

原因： ~/go/bin（Windowsの場合は%USERPROFILE%\go\bin）がPATHに含まれていません。

解決策：

「環境変数」を開く（スタートメニューで検索）
「ユーザー変数」のPathを見つける
「編集」→「新規」をクリック
追加：C:\Users\YourName\go\bin（YourNameを置き換える）
すべてのダイアログで「OK」をクリック
ターミナルを再起動

確認:

PowerShell

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

~/.zshrc（macOS）または~/.bashrc（Linux）に追加：

bash

export PATH=$PATH:~/go/bin

再読み込み：

bash

source ~/.zshrc  # または ~/.bashrc

確認:

bash

echo $PATH | grep go/bin
wails3 version

---

`wails3 doctor`で依存関係の不足が報告される

Linux： 出力にインストールが必要なパッケージが正確に表示されます。例：

❌ webkit2gtk が見つかりません
   インストール方法：sudo apt install libwebkit2gtk-4.1-dev

Windows： WebView2が見つからない場合：

Microsoft からダウンロード
または最初のアプリ実行時に自動的にインストールされます

macOS： Xcodeツールが見つからない場合：

bash

xcode-select --install

Go のバージョンが古すぎます

Wails v3 には Go 1.25+ が必要です。それより古いバージョンをお使いの場合:

go.dev/dl から最新バージョンをダウンロードして再インストールしてください。

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

bash

sudo rm -rf /usr/local/go
sudo tar -C /usr/local -xzf go1.25.linux-amd64.tar.gz

開発版 (Bleeding Edge)

メイン開発ブランチからの最新のコードを使用したいですか？これにより、リリース前に新機能や修正にアクセスできますが、バグや破壊的変更のリスクが伴います。コントリビューターや、今後の新機能をテストする必要がある人にのみ推奨されます。

bash

git clone https://github.com/wailsapp/wails.git
cd wails
git checkout v3
cd v3/cmd/wails3
go install

次のステップ

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

最初のアプリをビルド

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

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

テンプレートを探検

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

bash

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

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

インストール

クイックインストール（5分）

ステップバイステップのインストール

Goのインストール（必須）

プラットフォーム依存関係のインストール

Wails CLIのインストール

インストールの確認

npmのインストール（オプションですが推奨）

トラブルシューティング

wails3コマンドが見つからない

wails3 doctorで依存関係の不足が報告される

Go のバージョンが古すぎます

開発版 (Bleeding Edge)

次のステップ

`wails3`コマンドが見つからない

`wails3 doctor`で依存関係の不足が報告される