macOS 上安装 Wails 3（wails3）步骤

在 macOS 上已经安装好 Go 之后，安装 Wails 3（wails3） 的步骤其实非常简单。核心命令来自官方文档 v3alpha.wails.io。

✅ 一句话快速安装

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

🧰 完整步骤（macOS）

1. 确认 Go 版本

Wails 3 需要 Go 1.25+ v3alpha.wails.io
检查版本：

go version

2. 确保 GOPATH/bin 在 PATH 中

Wails CLI 会被安装到 ~/go/bin，你必须把它加入 PATH。

检查：

echo $PATH | grep go/bin

如果没有，添加到 ~/.zshrc：

echo 'export PATH=$PATH:~/go/bin' >> ~/.zshrc
source ~/.zshrc

3. 安装 Xcode Command Line Tools（必须）

Wails 3 在 macOS 上依赖 WebKit，需要 Xcode 工具链 v3alpha.wails.io：

xcode-select --install

确认安装成功：

xcode-select -p

4. 安装 Wails 3 CLI

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

5. 验证安装

wails3 doctor

如果所有检查通过，你就可以开始创建项目了。

🚀 创建你的第一个 Wails 3 项目

wails3 init -n myapp
cd myapp
wails3 dev

❗常见问题

❌ zsh: command not found: wails3

通常是因为 ~/go/bin 不在 PATH 中（Wails 2 时代也有类似问题） Github。

解决方法：

export PATH=$PATH:~/go/bin