go 1.16起默认启用go mod，需正确配置goproxy（如goproxy.cn）和gomodcache，确保目录可写、无嵌套go.mod、路径无空格中文，goroot一般无需设置，gopath仅用于go install二进制存放。
Go 1.16 起默认启用 go mod，不再依赖 GOPATH 目录结构；但若未正确设置 GOMODCACHE 或代理，go get 会卡住或报错 module not found —— 这不是环境没装好，而是模块生态的网络和缓存配置没跟上。
go version 验证通过但 go mod init 失败
常见现象是执行 go mod init example.com/hello 后提示 go: cannot determine module path for source directory，或直接卡在 “Fetching…” 状态。
- 根本原因：当前目录不在
GOPATH/src下（旧模式），而新模块模式要求目录可写、无嵌套go.mod、且路径不包含空格或中文 - 解决办法：用绝对路径切换到干净目录，例如
D:\projects\hello或~/go-dev/hello，再运行go mod init - 关键检查点：运行
go env GOMOD，输出应为当前目录下的go.mod路径；若为空，说明 Go 未识别该目录为模块根
国内环境下 go get 总超时或 403
这是最常被忽略的环节：Go 模块默认从 proxy.golang.org 拉包，国内直连失败率极高，go get 表现为长时间无响应或返回 Get "https://proxy.golang.org/...": dial tcp: i/o timeout。
- 必须设置代理：执行
go env -w GOPROXY=https://goproxy.cn,direct（推荐goproxy.cn）或go env -w GOPROXY=https://mirrors.aliyun.com/goproxy/,direct - 跳过校验（仅开发阶段）：
go env -w GOSUMDB=off，避免因 checksum 验证失败中断下载 - 验证是否生效：运行
go env GOPROXY，确认输出含你设置的地址；再试go get github.com/go-sql-driver/mysql，几秒内应开始下载
GOROOT 和 GOPATH 还需要手动配吗？
GOROOT 一般不用动 —— 安装程序已写死（Windows 默认 C:\Go，macOS/Linux 默认 /usr/local/go）；GOPATH 在模块模式下也不强制，但仍有实际用途。
-
GOROOT：仅当你把 Go 解压到非标准路径（如D:\go）时才需go env -w GOROOT=D:\go -
GOPATH：现在主要用于存放go install的二进制（如go install github.com/codeskyblue/gomobile@latest生成的gomobile命令），建议设为~/go并确保$GOPATH/bin在系统PATH中 - 注意陷阱：不要把项目目录建在
$GOPATH/src下再启模块 —— 这会导致 Go 混淆旧 GOPATH 模式与新模块模式，出现cannot find module providing package
真正卡住人的从来不是 go version 能否跑通，而是 go mod download 是否静默成功、go list -m all 是否列出依赖树、以及 go build 时有没有去拉私有仓库的 token —— 这些细节不显眼，但决定了模块能否真正“活”起来。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
