答案：go mod download超时或报错主因是goproxy未正确配置或未生效，国内必须设为https://goproxy.cn,direct并配goprivate处理私有模块，同时避免goroot与gopath路径冲突及系统包管理器安装的go版本滞后问题。
go version 能跑，但 go mod download 总超时或报错
这不是 Go 没装好，而是代理没生效或配置错位。国内直连 proxy.golang.org 基本不可用，常见错误包括：go: github.com/xxx@v1.2.3: reading https://proxy.golang.org/...: unexpected EOF、no matching versions for query "latest"。
必须显式设置 GOPROXY，且不能只写一个地址：
-
go env -w GOPROXY=https://goproxy.cn,direct是最低可用配置 - 若公司有私有模块（如
gitlab.internal/mylib），必须额外加go env -w GOPRIVATE=gitlab.internal - Linux/macOS 改完要
source ~/.zshrc（或~/.bashrc）；Windows 用「系统属性 → 环境变量」图形界面设，PowerShell 临时设置无效 - 验证是否真生效：
go env GOPROXY输出必须是完整字符串，不是空或https://proxy.golang.org
GOROOT 和 GOPATH 能不能设成同一个目录
绝对不行。设成一样会导致 go install 尝试往 $GOROOT/bin 写可执行文件，触发权限拒绝，或覆盖 go、gofmt 等核心工具。
正确路径组合示例：
-
GOROOT=/usr/local/go（Linux/macOS）或C:\Go（Windows）—— 必须指向解压/安装根目录，不能带软链接、不能有尾部斜杠 -
GOPATH=$HOME/go（Linux/macOS）或%USERPROFILE%\go（Windows）—— 必须是用户可写独立路径 -
PATH中顺序必须是$GOROOT/bin:$GOPATH/bin:$PATH，否则可能调用到旧版go
为什么用 apt/yum 安装的 go 总出问题
系统包管理器装的 Go 多数滞后 2～4 个小版本，更致命的是：GOROOT 被硬编码进二进制，go env -w GOROOT=... 无效，导致 go build 找不到 fmt 等标准库，报 cannot find package "fmt"。
Go 配置库，使用 spf13/viper — 分层优先级（flag > env >file > KV > default），提供 BindPFlag/BindPFlags、SetEnvPrefix + SetEnvKeyReplace 等功能。
ARM64 服务器上还可能出现 cannot execute binary file: Exec format error。根本解法只有一个：
- 删掉系统包：Ubuntu 上
sudo apt remove golang-go，CentOS 上sudo yum remove golang - 去官网或阿里云镜像站下载
.tar.gz（Linux）、.pkg（macOS）、.msi（Windows）—— 这些包自带正确路径和权限 - 解压/安装后手动配环境变量（Windows .msi 默认配好，但建议仍检查
go env GOROOT）
VS Code 里 go tools 安装失败或提示 missing gopls
本质还是代理问题。VS Code 的 Go 插件会自动调用 go install 下载 gopls、dlv 等工具，但默认走 GOPROXY，如果没配或配错，就会卡在 “Installing tools…”。
别点插件里的 “Install All”，改用终端手动装：
- 先确认代理已生效：
go env GOPROXY - 运行：
go install golang.org/x/tools/gopls@latest - 再装调试器：
go install github.com/go-delve/delve/cmd/dlv@latest - 重启 VS Code，打开
.go文件，看状态栏左下角是否显示 “gopls” 正常连接
如果 go install 报 module lookup disabled by -mod=readonly，说明当前目录有 go.mod 且处于只读模式，临时加 -mod=mod 参数即可：go install -mod=mod golang.org/x/tools/gopls@latest。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
