Wails 安装环境搭建指南Go 跨平台桌面应用一步到位【免费下载链接】wailsCreate beautiful applications using Go项目地址: https://gitcode.com/gh_mirrors/wa/wailsWails 是「Go 写后端 网页技术写前端」的跨平台桌面应用框架一条命令就能把两者打包进同一个可执行文件。照本指南走完你能在 Windows / macOS / Linux 上把 Wails 开发环境装好、自检通过并立刻动手创建第一个项目。动工前自检清单动手前先对一遍下表缺什么补什么避免装到一半返工。检查项要求等级怎么确认操作系统Windows 10/11macOS 10.15Intel/ 11Apple 芯片Linux 建议 Ubuntu 24.04 或 Debian 13 及以上必备看系统关于页Go1.25 及以上必备go versionPATH已含~/go/binWindows 为%USERPROFILE%\go\bin—必备echo $PATH \| grep go/bin前端包管理器npm 或 bun/pnpm 等建议 LTS 版 Node模板默认依赖它建议npm --versionUPX压缩体积、NSISWindows 安装包、Docker跨平台构建—可选用到再加wails3 doctor会提示三大平台依赖速装Windows基本零依赖。WebView2 Runtime 多数机器已自带万一缺失后面跑wails3 doctor时会明确提示你补装。macOS只需补齐 Xcode 命令行工具WebKit 系统已内置xcode-select --installLinux需要 C 编译工具链 GTK4 WebKitGTK 6.0 开发库按发行版挑一条执行Ubuntu / Debiansudo apt install build-essential pkg-config libgtk-4-dev libwebkitgtk-6.0-devFedorasudo dnf install gcc pkg-config gtk4-devel webkitgtk6.0-develArchsudo pacman -S base-devel gtk4 webkitgtk-6.0提示Ubuntu 22.04 / Debian 12 这类只提供 WebKit2GTK 4.1 的旧系统改装libgtk-3-dev libwebkit2gtk-4.1-dev并在后续构建时加-tags gtk3走旧版栈。可选工具一行流UPX 做二进制压缩、NSIS 打 Windows 安装包、Docker 做跨平台构建——按需添置即可。安装 wails3 并跑通自检go install github.com/wailsapp/wails/v3/cmd/wails3latest装完先确认wails3能被找到再二选一自检跑wails3 setup进交互式向导会顺带帮你装依赖、配置默认值目前仍属实验功能Linux 上测试最充分或直接wails3 doctor逐项体检。wails3 doctor会打印系统信息、Go 版本和依赖清单结尾出现SUCCESS Your system is ready for Wails development!即算通过。卡住了3 招快速定位现象提示找不到wails3命令。根因~/go/bin不在PATH里或终端没刷新环境变量。一招修复把export PATH$PATH:~/go/bin写进~/.zshrc/~/.bashrcWindows 去「环境变量」把%USERPROFILE%\go\bin加进 Path然后重开终端。现象go install报 Go 版本不满足要求。根因本机 Go 低于 1.25。一招修复从 go.dev/dl 重装最新版go version复核。现象Linux 下 doctor 报 WebKit 组件缺失或版本不对。根因发行版未提供 WebKitGTK 6.0 开发库。一招修复按上面 Linux 小节装对应包旧系统改走-tags gtk3旧栈。现象wails3 setup向导报错。根因向导偏新、覆盖面有限。一招修复退回手动装依赖 wails3 doctor验证的稳妥路线。下一步环境就绪现在就动手先wails3 init -l看看有哪些前端模板再选一个创建你的首个项目跑起来。更多细节见官方安装文档 getting-started/installation创建第一个应用看 quick-start/first-app。【免费下载链接】wailsCreate beautiful applications using Go项目地址: https://gitcode.com/gh_mirrors/wa/wails创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考