安装
- Windows 10/11 AMD64/ARM64
- macOS 10.15+ AMD64 (可部署到 macOS 10.13+)
- macOS 11.0+ ARM64
- Ubuntu 24.04 AMD64/ARM64 (其他 Linux 发行版也可能可用！)
Wails 有一些在安装前必须安装的通用依赖项：
从 Go 下载页面 下载 Go。
请确保遵循官方的 Go 安装说明。你还需要确保 PATH 环境变量中包含 ~/go/bin 目录的路径。重启终端并执行以下检查：
- 检查 Go 是否正确安装：
go version - 检查
~/go/bin是否在 PATH 变量中- Mac / Linux:
echo $PATH | grep go/bin - Windows:
$env:PATH -split ';' | Where-Object { $_ -like '*\go\bin' }
- Mac / Linux:
虽然 Wails 不要求必须安装 npm，但大多数内置模板都需要它。
从 Node 下载页面 下载最新的 Node 安装程序。最好使用最新版本，因为这是我们通常测试的版本。
运行 npm --version 进行验证。
平台特定的依赖项
Section titled “平台特定的依赖项”你还需要安装平台特定的依赖项：
Wails 要求安装 xcode 命令行工具。可以通过运行以下命令来完成：
xcode-select --installWails 要求安装 WebView2 Runtime。几乎所有的 Windows 安装都已经安装了此组件。你可以使用 wails doctor 命令进行检查。
Linux 需要标准的 gcc 构建工具以及 gtk3 和 webkit2gtk。安装后运行 wails doctor 以查看如何安装这些依赖项。如果你的发行版/包管理器不受支持，请在 Discord 上通知我们。
要使用 Go Modules 安装 Wails CLI，请运行以下命令：
go install -v github.com/wailsapp/wails/v3/cmd/wails3@latest如果你想安装最新的开发版本，请运行以下命令：
git clone https://github.com/wailsapp/wails.gitcd wailscd v3/cmd/wails3go install使用开发版本时，所有生成的项目都将使用 Go 的 replace 指令，以确保项目使用 Wails 的开发版本。
运行 wails3 doctor 将检查你是否安装了正确的依赖项。如果没有，它将告知你缺少什么，并帮助解决任何问题。
wails3 命令似乎丢失了？
Section titled “wails3 命令似乎丢失了？”如果你的系统报告 wails3 命令丢失，请检查以下内容：
- 确保你已正确遵循上述
Go 安装指南，并且go/bin目录在PATH环境变量中。 - 关闭/重新打开当前终端以获取新的
PATH变量。