WAILS安装

支持的平台

Windows 10/11 AMD64/ARM64
MacOS 10.13+ AMD64
MacOS 11.0+ ARM64
Linux AMD64/ARM64

依赖

Wails 有许多安装前需要的常见依赖项：

Go 1.18+
NPM (Node 15+)
Go
从 Go 下载页面 下载 Go。

确保您遵守官方的 Go 安装说明。 您还需要确保您的 PATH 环境变量包含您的 ~/go/bin 目录路径。 重启终端并执行以下命令检查：

检查 Go 是否安装正确： go version
检查 “~/go/bin” 是否在您的 PATH 变量中： echo $PATH | grep go/bin
NPM
从 Node 下载页面 下载 NPM。 最好使用最新版本，因为这是我们通常会测试的版本。

运行 npm --version 进行验证。

平台特定依赖关系
您还需要安装平台特定的依赖项：

Windows

Wails 要求安装 WebView2 运行时。 一些 Windows 安装已经安装了这个。 您可以使用 wails doctor 命令进行检查。

MacOS

Wails 要求安装 xcode 命令行工具。 这可以通过运行 xcode-select --install 来完成。

Linux

Linux 需要标准的 gcc 构建工具以及 libgtk3 和 libwebkit。 与其为不同的发行版列出大量命令，Wails 可以尝试确定针对您的特定发行版的安装命令。 安装后运行 wails doctor 以显示如何安装依赖项。 如果您的发行版/包管理器不受支持，请参阅 添加Linux发行版指南。

可选依赖
UPX 用于压缩您的应用程序。
NSIS 用于生成 Windows 安装程序。

安装 Wails
运行

go install github.com/wailsapp/wails/v2/cmd/wails@latest 

安装 Wails CLI。

注意：如果您遇到了类似于以下内容的错误：

....\Go\pkg\mod\github.com\wailsapp\wails\v2@v2.1.0\pkg\templates\templates.go:28:12: pattern all:ides/*: no matching files found

请检查您是否已安装 Go 1.18+ ︰

go version

系统检查

运行 wails doctor 将检查您是否安装了正确的依赖项。 如果没有，它会就缺少的内容提供建议以帮助纠正问题。

wails 命令好像不见了？

如果您的系统报告缺少 wails 命令，请确保您已正确遵循 Go 安装指南。 通常，这意味着您的用户 home 目录中的 go/bin 目录不在 PATH 环境变量中。 通常情况下还需要关闭并重新打开任何已打开的命令提示符，以便安装程序对环境所做的更改反映在命令提示符中。

创建项目

项目生成
现在 CLI 已安装，您可以使用 wails init 命令生成一个新项目。

选择您最喜欢的框架：
Svelte
React
Vue
Preact
Lit
Vanilla

wails init -n myproject -t vue-ts

最后运行 wails dev