macOS 上安装 Wails 3（wails3）步骤

WMSmile2026-04-16 14:50

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

bash 复制代码

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

Wails 3 需要 Go 1.25+ v3alpha.wails.io

检查版本：

bash 复制代码

go version

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

检查：

bash 复制代码

echo $PATH | grep go/bin

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

bash 复制代码

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

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

bash 复制代码

xcode-select --install

确认安装成功：

bash 复制代码

xcode-select -p

bash 复制代码

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

bash 复制代码

wails3 doctor

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

bash 复制代码

wails3 init -n myapp
cd myapp
wails3 dev

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

解决方法：

bash 复制代码

export PATH=$PATH:~/go/bin