根本原因是默认代理 proxy.golang.org 国内不可达，必须配置 go111module=on、goproxy=https://goproxy.cn,direct 和 gosumdb=off 三者同时生效，否则依赖下载、gopls 安装及校验均会失败。
国内拉不到依赖、go get 卡住、gopls 安装失败——这些问题不是环境没装好，而是代理没配对或没生效。Go 1.11+ 默认启用 Modules，但不配代理，连 golang.org/x 下的包都下不动。
为什么 go mod download 总是超时或报错
根本原因不是网络差，而是 Go 默认走 proxy.golang.org（境外），国内直连基本失败。错误典型如：
go: github.com/gorilla/mux@v1.8.0: Get "https://proxy.golang.org/github.com/gorilla/mux/@v/v1.8.0.info": dial tcp 216.239.37.1:443: i/o timeoutgo: golang.org/x/sys@v0.18.0: Get "https://proxy.golang.org/golang.org/x/sys/@v/v0.18.0.info": EOF
必须显式配置国内镜像代理，且要确保三个关键项同时生效：
-
GO111MODULE=on：强制启用模块模式（新版默认开启，但旧项目或误关后需手动开） -
GOPROXY=https://goproxy.cn,direct：七牛云代理为主，回源用direct（避免私有包拉不到） -
GOSUMDB=sum.golang.org→ 改为GOSUMDB=off或sum.golang.google.cn：否则校验失败会中断下载
执行这三条命令一次配全：
go env -w GO111MODULE=on<br>go env -w GOPROXY=https://goproxy.cn,direct<br>go env -w GOSUMDB=off
gopls 和调试工具安装失败怎么办
VS Code 首次打开 .go 文件时提示安装 gopls、dlv 等，但点击 “Install All” 后卡在 golang.org/x/tools —— 这是代理没覆盖到工具链安装过程。
Go语言（Golang）1.26.0
下载
Go语言（Golang）1.26.0版本提供 Go 官方 Windows amd64 MSI 安装包下载入口，版本号 1.26.0，可用于旧项目维护、兼容性测试和指定版本开发环境配置。
正确做法是绕过 IDE 提示，手动用 go install 安装，并确保命令走的是已配好的代理：
- 先确认代理生效：
go env GOPROXY输出应为https://goproxy.cn,direct - 再运行（Go 1.21+ 推荐用新命令）：
go install golang.org/x/tools/gopls@latest - 如果仍失败，加
-v看哪一步卡住，大概率是golang.org/x子模块，此时可临时换源：go install -v golang.org/x/tools/gopls@latest前先执行git config --global url."https://gitee.com/golang-x/".insteadOf "https://golang.org/x/"（仅限极个别情况）
Docker 开发环境里代理失效的常见坑
用 docker build 或 docker-compose up 构建时，容器内 go mod download 又变慢或失败——因为容器没继承宿主机的 go env 配置。
必须在构建阶段显式注入代理设置：
- Dockerfile 中，在
RUN go mod download前加：ENV GOPROXY=https://goproxy.cn,direct - 若用
go run启动服务，也建议在CMD前加ENV，避免运行时动态拉包失败 - 注意：Alpine 镜像中
ca-certificates缺失会导致 HTTPS 代理握手失败，需加RUN apk add --no-cache ca-certificates
代理配置不是“设一次就永远有效”，每次升级 Go 版本、切换项目、或重装系统后都要重新验证 go env | grep -E "(PROXY|MODULE|SUMDB)"。最容易被忽略的是 GOSUMDB，它不报明显错误，但会让 go mod verify 静默失败，最终导致依赖缓存损坏、反复重下。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
