解决 Go 安装 Wails 时的网络连接问题

在使用 Go 语言安装 Wails 框架时，可能会遇到因网络问题导致的安装失败。本文将详细介绍问题的原因及解决方法。

问题重现

在 Windows 系统的命令行（CMD）中执行以下命令安装 Wails：

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

可能会遇到如下错误：

go: github.com/wailsapp/wails/v2/cmd/wails@latest: module github.com/wailsapp/wails/v2/cmd/wails: Get "https://proxy.golang.org/github.com/wailsapp/wails/v2/cmd/wails/@v/list": dial tcp 142.250.204.49:443: connectex: A connection attempt failed because the connected party did not properly respond after a period of time, or established connection failed because connected host has failed to respond.

检查 Go 版本：

go version
# 输出：go version go1.25.3 windows/amd64

原因分析

该错误是由于 Go 默认使用的模块代理 proxy.golang.org 在国内访问不稳定或被阻断所致。当 go install 尝试从该代理下载依赖时，连接超时失败。

解决方案

对于 Go 1.13 及以上版本（当前使用版本为 1.25.3），推荐通过修改 Go 的环境变量来解决。具体步骤如下：

1. 开启 Go Modules

首先确保 GO111MODULE 设置为 on。在终端执行：

go env -w GO111MODULE=on

2. 更换国内代理

将 GOPROXY 设置为国内可访问的代理地址，例如 https://goproxy.cn（由七牛云提供，稳定且快速）：

go env -w GOPROXY=https://goproxy.cn,direct

说明：direct 表示若代理中找不到对应模块，则直接回源到版本控制系统（如 GitHub）获取。https://goproxy.cn/

3. 验证配置

执行以下命令查看环境变量是否修改成功：

go env GO111MODULE
go env GOPROXY

4. 重新安装 Wails

完成上述配置后，再次执行安装命令：

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

此时，安装过程应能顺利通过，不再出现网络超时错误。

补充说明

• 上述配置为全局生效，之后所有的 go get 或 go install 操作都会使用该代理。

• 如果仍有其他网络问题，也可尝试更换其他国内代理，如：

  • https://goproxy.io,direct

  • https://goproxy.cn,direct（推荐）

  • https://mirrors.aliyun.com/goproxy/,direct

结语

通过修改 Go 的模块代理配置，可以有效解决因网络原因导致的依赖下载失败问题。这不仅适用于 Wails 的安装，也适用于其他 Go 项目的依赖管理。希望本文能帮助遇到类似问题的开发者快速解决环境配置障碍。

:: -----------------------------------------------------
:: - 🚀 Powered by Moshow 郑锴
:: - 🌟 Might the holy code be with you!
:: -----------------------------------------------------
:: 🔍 公众号 👉 软件开发大百科
:: 💻 CSDN 👉 https://zhengkai.blog.csdn.net
:: 📂 GitHub 👉 https://github.com/moshowgame