Wails项目安装指南：跨平台桌面应用开发环境搭建

Wails项目安装指南：跨平台桌面应用开发环境搭建

wails wailsapp/wails: 是一个用于开发跨平台桌面应用程序的框架，使用 Web 技术（如 JavaScript，HTML 和 CSS）构建应用程序界面和逻辑，可以用于开发高性能和响应式的桌面应用程序。 项目地址: https://gitcode.com/gh_mirrors/wa/wails

前言

Wails是一个强大的框架，允许开发者使用Go语言构建现代化的桌面应用程序。它结合了Go的后端处理能力和前端技术（如HTML/CSS/JavaScript），为开发者提供了创建跨平台应用的便捷方式。本文将详细介绍如何在Windows、MacOS和Linux系统上安装Wails及其所有依赖项。

系统要求

在开始安装之前，请确保您的操作系统满足以下最低要求：

• Windows系统：Windows 10/11（支持AMD64和ARM64架构）
• MacOS系统：
  • 开发环境：MacOS 10.15+（AMD64）
  • 发布环境：MacOS 10.13+
  • M1芯片：MacOS 11.0+（ARM64）
• Linux系统：支持AMD64和ARM64架构的主流发行版

基础依赖安装

1. Go语言环境

Wails基于Go语言开发，因此需要先安装Go环境：

1. 下载并安装Go 1.21或更高版本（对于MacOS 15+系统，需要Go 1.23.3+）
2. 按照官方安装指南完成安装
3. 确保您的PATH环境变量包含~/go/bin目录
4. 验证安装：

   go version
   

5. 检查PATH配置：

   echo $PATH | grep go/bin
   

2. Node.js与NPM

前端开发需要Node.js环境：

1. 安装Node.js 15或更高版本（建议使用最新稳定版）
2. 验证安装：

   npm --version
   

平台特定依赖

Windows系统

1. 确保已安装WebView2运行时（部分Windows系统已预装）
2. 可通过以下命令检查：

   wails doctor
   

MacOS系统

1. 安装Xcode命令行工具：

   xcode-select --install
   

Linux系统

1. 需要安装标准GCC构建工具
2. 安装GTK3和WebKit相关库
3. 安装完成后运行：

   wails doctor
   

   该命令会检测您的发行版并给出相应的安装建议

注意：对于最新Linux版本（如Ubuntu 24.04），如果遇到libwebkit未找到的问题，可以安装libwebkit2gtk-4.1-dev并在构建时使用-tags webkit2_41参数。

可选依赖

虽然这些不是必需的，但它们可以增强您的开发体验：

1. UPX：用于压缩应用程序
2. NSIS：用于生成Windows安装程序

Wails CLI安装

安装Wails命令行工具：

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

常见问题：如果遇到类似pattern all:ides/*: no matching files found的错误，请检查您的Go版本是否为1.18或更高。

系统检查

安装完成后，运行系统诊断命令：

wails doctor

该命令会检查所有依赖项是否已正确安装，并指出任何缺失的组件或配置问题。

故障排除

如果系统报告找不到wails命令，可能是以下原因：

1. Go安装不正确
2. go/bin目录未添加到PATH环境变量中
3. 需要重新启动终端以使环境变量更改生效

结语

通过以上步骤，您应该已经成功搭建了Wails开发环境。Wails框架的强大之处在于它能够将Go的高效后端处理与现代化的前端技术无缝结合，为开发者提供创建跨平台桌面应用的便捷途径。安装完成后，您可以开始探索Wails提供的丰富功能，构建您的第一个桌面应用程序。

wails wailsapp/wails: 是一个用于开发跨平台桌面应用程序的框架，使用 Web 技术（如 JavaScript，HTML 和 CSS）构建应用程序界面和逻辑，可以用于开发高性能和响应式的桌面应用程序。 项目地址: https://gitcode.com/gh_mirrors/wa/wails