wailsapp/wails

这是什么？

核心功能

• 01前端 JavaScript 可直接调用 Go 方法，并自动生成 TypeScript 类型定义
• 02支持原生对话框、菜单以及深色/浅色模式
• 03Go 与 JavaScript 之间提供统一的事件系统
• 04命令行工具可创建、编译和打包项目，并提供前端模板
• 05支持 Windows、macOS 和 Linux，使用原生渲染引擎而非内嵌浏览器

适用场景

• 用 Go 搭配现代 Web 界面开发轻量桌面工具
• 为已有的 Go 程序添加图形界面，无需运行本地 Web 服务器
• 使用 React、Vue 或 Svelte 开发跨平台桌面应用

快速上手

1. 1

   使用 Go 安装 Wails v2 命令行工具

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

   使用 Go 安装 Wails v3 命令行工具（测试版）

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

   按照 Wails 文档站点上的完整安装说明操作

使用前须知

• !v3 仍处于测试版，v2 为稳定版本。
• !桌面应用除 Go 工具链外还需要特定平台的原生依赖。

标签

常见问题

wails 是什么？

一个用 Go 构建跨平台桌面应用的框架，前端可使用 React、Vue、Svelte 等 Web 技术。 Wails 让 Go 开发者可以把 Go 后端与 HTML、JavaScript、CSS 前端打包成一个二进制文件，直接以原生窗口运行，无需启动本地 Web 服务器再打开浏览器。

wails 可以免费使用吗？用的什么许可证？

wails 以 MIT 许可证开源。用于商业产品前，请先确认许可证条款。

wails 还在维护吗？

活跃维护中。wails 最近一次提交是在 2026年10月21日。

wails 适合用来做什么？

用 Go 搭配现代 Web 界面开发轻量桌面工具 为已有的 Go 程序添加图形界面，无需运行本地 Web 服务器 使用 React、Vue 或 Svelte 开发跨平台桌面应用

wails 怎么安装和运行？

使用 Go 安装 Wails v2 命令行工具: go install github.com/wailsapp/wails/v2/cmd/wails@latest 使用 Go 安装 Wails v3 命令行工具（测试版）: go install github.com/wailsapp/wails/v3/cmd/wails3@latest 按照 Wails 文档站点上的完整安装说明操作

在哪里获取 wails？

源代码和安装说明在 GitHub 上：https://github.com/wailsapp/wails