Windows 安装 Go + Wails 开发环境

491 字

2 分钟

2026-08-21

Wails 用 Go 写后端逻辑、前端用 HTML/CSS/JS（Vue/React 等）写界面，打包成单一桌面应用。本文记录 Windows 下的安装步骤。

环境要求#

到 https://go.dev/dl/ 下载 Windows MSI 安装包，双击安装。

1
go version

MSI 安装器会自动把 C:\Users\你的用户名\go\bin 加入 PATH。

到 https://nodejs.org/ 下载 LTS 版本，双击安装。

1
node --version
2
npm --version

CLI 是必需的（用来跑 init / dev / build），但全局安装不是必需的：

方式一，全局安装（推荐，省得每次敲长命令）：

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

重启终端让 PATH 生效，然后验证：

1
wails version

若提示命令找不到，把 %GOPATH%\bin（默认 C:\Users\你的用户名\go\bin）加入系统 PATH 并重启终端。

方式二，不想安装，直接用 go run 跑（效果一样，只是每次多打一段路径）：

1
go run github.com/wailsapp/wails/v2/cmd/wails@latest version

1
wails doctor

该命令会逐项检查 Go、Node、WebView2 是否齐全（gcc 仅在用到 cgo 时才检查），缺什么直接告诉你。

已全局安装 CLI 的：

1
wails init -n myapp -t vue
2
cd myapp
3
wails dev

用 go run 方式的，每条命令前加 go run github.com/wailsapp/wails/v2/cmd/wails@latest：

1
go run github.com/wailsapp/wails/v2/cmd/wails@latest init -n myapp -t vue
2
cd myapp
3
go run github.com/wailsapp/wails/v2/cmd/wails@latest dev

wails dev 自动安装依赖、生成绑定、编译并弹出桌面窗口（首次约 2-3 分钟）。前端模板 -t 可选 vue / react / svelte / vanilla。

打包发布：

1
wails build

产物位于 build/bin/。

现象	原因 / 解决
`gcc: command not found`	仅在使用 cgo 时出现；不用的话忽略，要用的话装 MinGW-w64 并把它 `bin` 加入 PATH
`pattern all:ides/*: no matching files found`	Go 版本过低，升级到 1.21+
WebView2 缺失	到微软官网下载 WebView2 Runtime 安装
`wails` 命令找不到	`go\bin` 未加入 PATH，或没重启终端（用了 `go run` 方式则不需要全局安装）