参与贡献

编辑此文档

翻译文档,或在您的计算机上打开完整项目。

在您选择提交工作成果之前,不会发布任何内容。

Wails 徽标Wails 徽标

使用 Go 构建桌面应用

使用 Go 和现代 Web 技术构建美观且高性能的应用。一个代码库,支持三个平台,无需浏览器。*

* 除非你确实想用浏览器

快速入门

# 1. Install the Wails CLI
go install github.com/wailsapp/wails/v3/cmd/wails3@latest

# 2. Run the setup wizard (experimental)
wails3 setup

然后就可以开始创建第一个项目了:

wails3 init -n myapp -t vanilla
cd myapp && wails3 dev

你的应用现已运行,并支持热重载和类型安全的 Go 到 JS 绑定。

使用wails3 setup时遇到问题?请参阅手动安装指南。

你的桌面应用已经是移动应用

wails3 task ios:run      # run your existing app on iOS Simulator
wails3 task android:run  # run your existing app on Android Emulator

无需更改任何 Go 代码。使用相同的main.go、相同的服务和相同的前端,Wails 会自动将其编译为 iOS 和 Android 应用。触觉反馈、原生对话框和安全区域等平台特定功能可按需使用,但无需使用这些功能也能发布应用。

移动端文档 →


为什么选择 Wails?

用户可感知的性能提升
  • 二进制文件约为15MB,而 Electron 为150MB
  • 基准内存占用约为10MB,而对比对象为100MB 以上
  • 启动时间为<0.5秒,而对比对象为2-3秒
  • 使用操作系统 WebView 进行原生渲染
  • 没有捆绑浏览器带来的额外开销
开发者体验
  • 一个 Go 代码库支持所有平台
  • 可使用任意 Web 框架——React、Vue、Svelte
  • 开发期间支持热重载
  • 自动生成绑定,便于从 Javascript 调用 Go
  • 使用内存内 IPC,无需网络端口
为桌面应用而生
  • 支持多个窗口及其生命周期
  • 原生菜单和系统托盘
  • 平台原生文件对话框
  • 系统集成和快捷键
  • 代码签名和打包工具
桌面端与移动端
  • Windows、macOS、Linux、iOS、Android
  • 使用同一代码库,无需重写
  • 每个平台均使用原生 WebView
  • 不开放任何端口,也不需要 localhost 服务器
  • 可按需使用平台功能

后续步骤

接下来:构建一个完整的应用、浏览示例,或查看API 参考。要从 v2 迁移?请参阅升级指南。

支持 Wails 的开发

Wails 是由开发者为开发者打造的免费开源软件。如果 Wails 帮助你构建出色的应用,请考虑支持其持续开发。

你的赞助有助于维护项目、改进文档,并开发惠及整个社区的新功能。

成为赞助者 →