Wails 项目全览用 Go 与 Web 技术构建跨平台桌面应用【免费下载链接】wailsCreate beautiful applications using Go项目地址: https://gitcode.com/gh_mirrors/wa/wailsWails 是一个面向 Go 开发者的桌面应用框架核心思路是将 Go 后端代码与任意 Web 前端技术HTML/CSS/JS一并打包进单个可执行二进制文件用系统原生渲染引擎呈现 UI而非内嵌浏览器。本文以仓库根目录的 README.ru.md俄语版项目说明为骨架结合 v2/v3 两代 CLI 源码、绑定系统与示例工程系统讲解 Wails 的设计理念、核心特性、快速上手流程与常见疑问帮助你判断它是否适合你的下一个桌面应用项目。一、核心理念从浏览器 服务器到单一二进制传统上为 Go 程序提供 Web 界面通常需要内置一个 Web 服务器再让用户打开浏览器访问。Wails 提供了完全不同的思路Wails 将 Go 代码和 Web 前端包裹进同一个二进制EXE文件通过内置工具替你处理项目创建、编译与打包的完整流程你只需要专注于创意实现。这意味着最终交付物是一个不依赖用户环境中安装任何运行时、也不需要用户手动启动服务的单文件应用。从源码结构看这一理念贯穿两个代际v2稳定版仓库中的 v2 目录承载 CLI、运行时与绑定系统的实现v3Betav3 目录采用全新的架构引入 Taskfile 驱动的构建流程与更丰富的命令体系。两代版本当前均处于活跃开发状态README 以表格给出了各自的安装与文档入口详见下文快速开始。二、核心特性逐项解读README 列出了 12 项核心特性下面逐项结合仓库源码给出更具体的落地点。1. 后端使用标准 GoWails 不引入自定义语言或 DSL后端就是普通 Go 代码。业务逻辑以结构体Service形式挂载到应用中示例可参考 v2/examples/dragdrop-test/app.go 与 v3/examples/plain/main.go 等示例工程。2. 支持任何你熟悉的前端技术前端可以是 React、Vue、Svelte、原生 HTML 等任意技术栈。仓库内置大量模板见 v2/pkg/templates/templates 与 v2/pkg/templates/generate 目录涵盖 Vue、React、Svelte、TypeScript 等多种组合。3. 使用预置模板快速创建前端wails init -l可列出所有可用模板及简短名称帮助你在创建项目时快速选定。4. 从 JavaScript 轻量调用 Go 方法这是 Wails 的核心能力Go 方法通过绑定Binding机制暴露给前端。绑定系统的实现在 v2/internal/binding/binding.goBindings.Add(structPtr)通过反射reflect提取结构体的可导出方法并登记到绑定数据库DB中运行时由 v2/internal/frontend 下的调度器负责把前端调用路由回 Go 方法。在应用配置中通过options.App.Bind字段声明要绑定的结构体指针列表即可见下文应用配置。5. 为 Go 结构与函数自动生成 TypeScript 类型绑定系统内置 TypeScript 代码生成GenerateModels()会把已绑定结构体与枚举转换为.d.ts模型文件实现在 v2/internal/binding/binding.go 与 v2/internal/typescriptify让前端获得类型安全的调用体验。6. 原生对话框与菜单Wails 提供原生菜单与对话框能力v2 的菜单实现位于 v2/pkg/menu支持 macOS/Windows 差异化行为对话框 API 位于 v2/pkg/runtime/dialog.go。菜单可在 v2/pkg/options/options.go 的App.Menu字段中配置。7. 原生深色 / 浅色模式支持应用可跟随系统亮暗主题相关能力在 v2 前端运行时与平台适配层中体现v3 的 v3/internal/runtime 亦包含主题相关模块。8. 支持现代半透明与磨砂玻璃窗口效果窗口透明与模糊效果通过平台级选项提供例如 v2 的 v2/pkg/options/mac 与 v2/pkg/options/windows 目录中均有针对性的窗口效果配置项。9. Go 与 JavaScript 之间统一的事件系统前后端共享同一套事件机制Go 侧调用运行时EmitEvent/On等 API见 v2/pkg/runtime/events.go前端通过同名事件 API 收发实现双向通信。10. 强大的 CLI 工具v2 的 CLI 入口在 v2/cmd/wails/main.go基于clir框架注册了如下子命令命令作用wails build构建应用生产模式wails dev以开发模式运行应用带热重载wails doctor诊断本机环境wails init初始化新项目wails update更新 CLI 自身wails show releasenotes显示当前版本发布说明wails generate module/generate template生成 Wails 模块 / 模板wails version输出 CLI 版本v3 的 CLI入口 v3/cmd/wails3/main.go在此基础上扩展出package打包、mcpMCP 服务器、task运行 Taskfile 任务、generate bindings/constants/icons/syso等更细分的子命令。11. 跨平台Multiplatform支持 Windows、macOS、Linuxv3 还引入了 Android/iOS 支持见 v3/ANDROID.md、v3/IOS.md 与 v3/examples/android 示例。桌面端通过 v2/internal/frontend/desktop 与 v2/internal/platform 做平台适配。12. 使用原生渲染引擎不内嵌浏览器Wails 在 Windows 上使用 WebView2在 macOS 上使用 WKWebView在 Linux 上使用 WebKitGTK因此打包体积远小于 Electron 类方案。三、Roadmap 与 WEP 提案机制README 指出项目路线图通过官方讨论区维护并提醒在提出改进建议之前请先查阅路线图内容。英文版 README.md 补充说明了 WEPWails Enhancement Proposal机制新功能与公共行为变更会以 WEP 草案形式提交相关说明见 v3/wep/README.md以 Pull Request 而非 feature-request issue 的形式发起保证社区讨论与实现路线可控。四、快速开始从安装到运行官方文档提供了完整安装说明README 指向官方站点仓库内还保留了docs目录可供查阅。结合仓库源码标准流程如下。1. 安装 CLIv2 与 v3 是两个并行活跃的版本安装命令不同v2稳定版go install github.com/wailsapp/wails/v2/cmd/wailslatestv3Betago install github.com/wailsapp/wails/v3/cmd/wails3latest要求本机已安装 Go 工具链wails doctor可用于检查环境依赖是否齐全。2. 初始化项目wails init的内部实现位于 v2/cmd/wails/init.go其完整流程为校验项目名必须通过-n参数提供与 IDE 选项仅支持vscode、goland自动从 git 配置读取作者姓名与邮箱findAuthorDetails安装所选模板并写入默认 build assetsbuildassets.Install执行go mod edit -module 项目名将模块名改为项目名执行go mod tidy生成最新的go.sum移除模板自带的.git目录若指定了 git 初始化选项则重新执行git init并写入默认.gitignore忽略build/bin、frontend/dist、frontend/node_modules。常用参数示例wails init -n myapp -t vanilla # 指定项目名与模板 wails init -l # 列出所有可用模板3. 开发模式与构建wails dev # 开发模式热重载、调试支持 wails build # 生产构建输出单文件可执行程序wails dev的入口见 v2/cmd/wails/dev.go实际逻辑委托给 v2/cmd/wails/internal/dev 包构建相关参数输出目录、平台、清理等集中在 v2/cmd/wails/flags 目录。4. 应用配置与绑定一个最小 v2 应用的main.go通常形如err : wails.Run(options.App{ Title: 我的应用, Width: 1024, Height: 768, AssetServer: assetserver.Options{ Assets: assetFS }, OnStartup: app.startup, Bind: []interface{}{ app, // 绑定结构体前端即可调用其导出方法 }, })关键选项在 v2/pkg/options/options.go 中定义除上例外还包括窗口控制Fullscreen、Frameless、DisableResize、MinWidth/MinHeight/MaxWidth/MaxHeight、AlwaysOnTop、StartHidden、WindowStartStateNormal/Maximised/Minimised/Fullscreen四种状态生命周期钩子OnStartup、OnDomReady、OnShutdown、OnBeforeClose平台专属Windows、Mac、Linux三组子选项其他Menu原生菜单、BackgroundColour可用options.NewRGB/options.NewRGBA构造、DragAndDrop拖放行为、SingleInstanceLock单实例锁、EnableDefaultContextMenu等。未显式设置时MergeDefaults会补齐默认值例如宽高默认 1024×768。五、FAQ 深入解读README 的 FAQ 部分回答了三个高频问题这里结合仓库做进一步展开。1. Wails 是 Electron 的替代品吗取决于你的需求。Wails 旨在让 Go 程序员轻松创建轻量级桌面应用或为现有应用补充前端界面。它提供原生菜单、对话框等元素因此可以视为轻量级的 Electron 替代方案。两者定位的差异在于Electron 捆绑 Chromium 与 Node.js 运行时体积与内存开销较大而 Wails 使用系统原生 WebView 渲染见特性 12打包产物更小适合对体积敏感、且希望后端完全由 Go 承担的场景。仓库中 v2/examples 与 v3/examples 下的数十个示例菜单、托盘、对话框、拖放、通知、单实例等展示了这类应用能覆盖的典型能力面。2. 这个项目面向谁面向希望在应用中打包 HTML/JS/CSS 前端、却不想为此搭建服务器并打开浏览器查看的 Go 程序员。也就是说你的整个应用只有一个进程、一个窗口、一份产物。需要浏览器能力如复杂 DOM 兼容性时 WebView 能胜任需要系统能力时直接调用 Go 与原生 API。3. 名字从何而来作者看到 WebView 时联想到为构建 WebView 应用提供的工具链就像 Rails 之于 Ruby最初是 Webview on Rails 的文字游戏又恰好与作者家乡威尔士Wales的英文发音相同于是沿用下来。六、多语言支持与配套资源项目为全球开发者提供了多语种入口英文 README.md、简体中文 README.zh-Hans.md、日文 README.ja.md、韩文 README.ko.md、西班牙文 README.es.md、俄文 README.ru.md、法文 README.fr.md 等十余个版本站点文档更覆盖 de、fr、zh-cn、zh-tw 等二十余种语言并有翻译状态跟踪docs/mpress/translation/state保证各语种与原文同步。仓库内还提供以下可进一步探索的资源贡献指南CONTRIBUTING.md、v3/TESTING.md、docs/mpress/CONTRIBUTING.md官方示例v2 见 v2/examples含自定义布局、拖放、崩溃恢复等v3 见 v3/examples覆盖事件、菜单、托盘、窗口、WebSocket 传输等 40 场景变更记录CHANGELOG.md、v3/UNRELEASED_CHANGELOG.md移动端支持v3/ANDROID.md、v3/IOS.md文档站点源码website。七、许可证与开发灵感项目以 MIT 许可证开源LICENSE鼓励社区贡献仓库内提供了 CONTRIBUTORS.md 与完整的贡献者鸣谢页面。值得一提的是README 的灵感部分透露作者在创作 Wails 期间主要聆听的音乐专辑——从 Manic Street Preachers、Metallica 到 Ben Howard 等——这个细节也体现了开源项目背后的人文色彩。结语Wails 为 Go 开发者提供了一条用 Web 技术写界面、用 Go 写逻辑、最终交付单一可执行文件的轻量路径无需内置服务器不内嵌浏览器原生对话框、菜单、主题与事件系统一应俱全并配以自动生成 TypeScript 绑定的强大 CLI。如果你正寻找比 Electron 更轻的桌面方案且希望后端完全掌控在 Go 手中不妨从wails init -n hello开始结合本文提到的 v2/pkg/options/options.go、v2/internal/binding/binding.go 与 v2/cmd/wails/main.go 等源码入口一步步构建属于你自己的桌面应用。【免费下载链接】wailsCreate beautiful applications using Go项目地址: https://gitcode.com/gh_mirrors/wa/wails创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 Wails 项目全览：用 Go 与 Web 技术构建跨平台桌面应用
Wails 项目全览用 Go 与 Web 技术构建跨平台桌面应用【免费下载链接】wailsCreate beautiful applications using Go项目地址: https://gitcode.com/gh_mirrors/wa/wailsWails 是一个面向 Go 开发者的桌面应用框架核心思路是将 Go 后端代码与任意 Web 前端技术HTML/CSS/JS一并打包进单个可执行二进制文件用系统原生渲染引擎呈现 UI而非内嵌浏览器。本文以仓库根目录的 README.ru.md俄语版项目说明为骨架结合 v2/v3 两代 CLI 源码、绑定系统与示例工程系统讲解 Wails 的设计理念、核心特性、快速上手流程与常见疑问帮助你判断它是否适合你的下一个桌面应用项目。一、核心理念从浏览器 服务器到单一二进制传统上为 Go 程序提供 Web 界面通常需要内置一个 Web 服务器再让用户打开浏览器访问。Wails 提供了完全不同的思路Wails 将 Go 代码和 Web 前端包裹进同一个二进制EXE文件通过内置工具替你处理项目创建、编译与打包的完整流程你只需要专注于创意实现。这意味着最终交付物是一个不依赖用户环境中安装任何运行时、也不需要用户手动启动服务的单文件应用。从源码结构看这一理念贯穿两个代际v2稳定版仓库中的 v2 目录承载 CLI、运行时与绑定系统的实现v3Betav3 目录采用全新的架构引入 Taskfile 驱动的构建流程与更丰富的命令体系。两代版本当前均处于活跃开发状态README 以表格给出了各自的安装与文档入口详见下文快速开始。二、核心特性逐项解读README 列出了 12 项核心特性下面逐项结合仓库源码给出更具体的落地点。1. 后端使用标准 GoWails 不引入自定义语言或 DSL后端就是普通 Go 代码。业务逻辑以结构体Service形式挂载到应用中示例可参考 v2/examples/dragdrop-test/app.go 与 v3/examples/plain/main.go 等示例工程。2. 支持任何你熟悉的前端技术前端可以是 React、Vue、Svelte、原生 HTML 等任意技术栈。仓库内置大量模板见 v2/pkg/templates/templates 与 v2/pkg/templates/generate 目录涵盖 Vue、React、Svelte、TypeScript 等多种组合。3. 使用预置模板快速创建前端wails init -l可列出所有可用模板及简短名称帮助你在创建项目时快速选定。4. 从 JavaScript 轻量调用 Go 方法这是 Wails 的核心能力Go 方法通过绑定Binding机制暴露给前端。绑定系统的实现在 v2/internal/binding/binding.goBindings.Add(structPtr)通过反射reflect提取结构体的可导出方法并登记到绑定数据库DB中运行时由 v2/internal/frontend 下的调度器负责把前端调用路由回 Go 方法。在应用配置中通过options.App.Bind字段声明要绑定的结构体指针列表即可见下文应用配置。5. 为 Go 结构与函数自动生成 TypeScript 类型绑定系统内置 TypeScript 代码生成GenerateModels()会把已绑定结构体与枚举转换为.d.ts模型文件实现在 v2/internal/binding/binding.go 与 v2/internal/typescriptify让前端获得类型安全的调用体验。6. 原生对话框与菜单Wails 提供原生菜单与对话框能力v2 的菜单实现位于 v2/pkg/menu支持 macOS/Windows 差异化行为对话框 API 位于 v2/pkg/runtime/dialog.go。菜单可在 v2/pkg/options/options.go 的App.Menu字段中配置。7. 原生深色 / 浅色模式支持应用可跟随系统亮暗主题相关能力在 v2 前端运行时与平台适配层中体现v3 的 v3/internal/runtime 亦包含主题相关模块。8. 支持现代半透明与磨砂玻璃窗口效果窗口透明与模糊效果通过平台级选项提供例如 v2 的 v2/pkg/options/mac 与 v2/pkg/options/windows 目录中均有针对性的窗口效果配置项。9. Go 与 JavaScript 之间统一的事件系统前后端共享同一套事件机制Go 侧调用运行时EmitEvent/On等 API见 v2/pkg/runtime/events.go前端通过同名事件 API 收发实现双向通信。10. 强大的 CLI 工具v2 的 CLI 入口在 v2/cmd/wails/main.go基于clir框架注册了如下子命令命令作用wails build构建应用生产模式wails dev以开发模式运行应用带热重载wails doctor诊断本机环境wails init初始化新项目wails update更新 CLI 自身wails show releasenotes显示当前版本发布说明wails generate module/generate template生成 Wails 模块 / 模板wails version输出 CLI 版本v3 的 CLI入口 v3/cmd/wails3/main.go在此基础上扩展出package打包、mcpMCP 服务器、task运行 Taskfile 任务、generate bindings/constants/icons/syso等更细分的子命令。11. 跨平台Multiplatform支持 Windows、macOS、Linuxv3 还引入了 Android/iOS 支持见 v3/ANDROID.md、v3/IOS.md 与 v3/examples/android 示例。桌面端通过 v2/internal/frontend/desktop 与 v2/internal/platform 做平台适配。12. 使用原生渲染引擎不内嵌浏览器Wails 在 Windows 上使用 WebView2在 macOS 上使用 WKWebView在 Linux 上使用 WebKitGTK因此打包体积远小于 Electron 类方案。三、Roadmap 与 WEP 提案机制README 指出项目路线图通过官方讨论区维护并提醒在提出改进建议之前请先查阅路线图内容。英文版 README.md 补充说明了 WEPWails Enhancement Proposal机制新功能与公共行为变更会以 WEP 草案形式提交相关说明见 v3/wep/README.md以 Pull Request 而非 feature-request issue 的形式发起保证社区讨论与实现路线可控。四、快速开始从安装到运行官方文档提供了完整安装说明README 指向官方站点仓库内还保留了docs目录可供查阅。结合仓库源码标准流程如下。1. 安装 CLIv2 与 v3 是两个并行活跃的版本安装命令不同v2稳定版go install github.com/wailsapp/wails/v2/cmd/wailslatestv3Betago install github.com/wailsapp/wails/v3/cmd/wails3latest要求本机已安装 Go 工具链wails doctor可用于检查环境依赖是否齐全。2. 初始化项目wails init的内部实现位于 v2/cmd/wails/init.go其完整流程为校验项目名必须通过-n参数提供与 IDE 选项仅支持vscode、goland自动从 git 配置读取作者姓名与邮箱findAuthorDetails安装所选模板并写入默认 build assetsbuildassets.Install执行go mod edit -module 项目名将模块名改为项目名执行go mod tidy生成最新的go.sum移除模板自带的.git目录若指定了 git 初始化选项则重新执行git init并写入默认.gitignore忽略build/bin、frontend/dist、frontend/node_modules。常用参数示例wails init -n myapp -t vanilla # 指定项目名与模板 wails init -l # 列出所有可用模板3. 开发模式与构建wails dev # 开发模式热重载、调试支持 wails build # 生产构建输出单文件可执行程序wails dev的入口见 v2/cmd/wails/dev.go实际逻辑委托给 v2/cmd/wails/internal/dev 包构建相关参数输出目录、平台、清理等集中在 v2/cmd/wails/flags 目录。4. 应用配置与绑定一个最小 v2 应用的main.go通常形如err : wails.Run(options.App{ Title: 我的应用, Width: 1024, Height: 768, AssetServer: assetserver.Options{ Assets: assetFS }, OnStartup: app.startup, Bind: []interface{}{ app, // 绑定结构体前端即可调用其导出方法 }, })关键选项在 v2/pkg/options/options.go 中定义除上例外还包括窗口控制Fullscreen、Frameless、DisableResize、MinWidth/MinHeight/MaxWidth/MaxHeight、AlwaysOnTop、StartHidden、WindowStartStateNormal/Maximised/Minimised/Fullscreen四种状态生命周期钩子OnStartup、OnDomReady、OnShutdown、OnBeforeClose平台专属Windows、Mac、Linux三组子选项其他Menu原生菜单、BackgroundColour可用options.NewRGB/options.NewRGBA构造、DragAndDrop拖放行为、SingleInstanceLock单实例锁、EnableDefaultContextMenu等。未显式设置时MergeDefaults会补齐默认值例如宽高默认 1024×768。五、FAQ 深入解读README 的 FAQ 部分回答了三个高频问题这里结合仓库做进一步展开。1. Wails 是 Electron 的替代品吗取决于你的需求。Wails 旨在让 Go 程序员轻松创建轻量级桌面应用或为现有应用补充前端界面。它提供原生菜单、对话框等元素因此可以视为轻量级的 Electron 替代方案。两者定位的差异在于Electron 捆绑 Chromium 与 Node.js 运行时体积与内存开销较大而 Wails 使用系统原生 WebView 渲染见特性 12打包产物更小适合对体积敏感、且希望后端完全由 Go 承担的场景。仓库中 v2/examples 与 v3/examples 下的数十个示例菜单、托盘、对话框、拖放、通知、单实例等展示了这类应用能覆盖的典型能力面。2. 这个项目面向谁面向希望在应用中打包 HTML/JS/CSS 前端、却不想为此搭建服务器并打开浏览器查看的 Go 程序员。也就是说你的整个应用只有一个进程、一个窗口、一份产物。需要浏览器能力如复杂 DOM 兼容性时 WebView 能胜任需要系统能力时直接调用 Go 与原生 API。3. 名字从何而来作者看到 WebView 时联想到为构建 WebView 应用提供的工具链就像 Rails 之于 Ruby最初是 Webview on Rails 的文字游戏又恰好与作者家乡威尔士Wales的英文发音相同于是沿用下来。六、多语言支持与配套资源项目为全球开发者提供了多语种入口英文 README.md、简体中文 README.zh-Hans.md、日文 README.ja.md、韩文 README.ko.md、西班牙文 README.es.md、俄文 README.ru.md、法文 README.fr.md 等十余个版本站点文档更覆盖 de、fr、zh-cn、zh-tw 等二十余种语言并有翻译状态跟踪docs/mpress/translation/state保证各语种与原文同步。仓库内还提供以下可进一步探索的资源贡献指南CONTRIBUTING.md、v3/TESTING.md、docs/mpress/CONTRIBUTING.md官方示例v2 见 v2/examples含自定义布局、拖放、崩溃恢复等v3 见 v3/examples覆盖事件、菜单、托盘、窗口、WebSocket 传输等 40 场景变更记录CHANGELOG.md、v3/UNRELEASED_CHANGELOG.md移动端支持v3/ANDROID.md、v3/IOS.md文档站点源码website。七、许可证与开发灵感项目以 MIT 许可证开源LICENSE鼓励社区贡献仓库内提供了 CONTRIBUTORS.md 与完整的贡献者鸣谢页面。值得一提的是README 的灵感部分透露作者在创作 Wails 期间主要聆听的音乐专辑——从 Manic Street Preachers、Metallica 到 Ben Howard 等——这个细节也体现了开源项目背后的人文色彩。结语Wails 为 Go 开发者提供了一条用 Web 技术写界面、用 Go 写逻辑、最终交付单一可执行文件的轻量路径无需内置服务器不内嵌浏览器原生对话框、菜单、主题与事件系统一应俱全并配以自动生成 TypeScript 绑定的强大 CLI。如果你正寻找比 Electron 更轻的桌面方案且希望后端完全掌控在 Go 手中不妨从wails init -n hello开始结合本文提到的 v2/pkg/options/options.go、v2/internal/binding/binding.go 与 v2/cmd/wails/main.go 等源码入口一步步构建属于你自己的桌面应用。【免费下载链接】wailsCreate beautiful applications using Go项目地址: https://gitcode.com/gh_mirrors/wa/wails创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考