go modules依赖管理失效的主因是go111module未设为on，导致退化为gopath模式而失败；必须执行go env -w go111module=on并验证输出为on，同时配置goproxy=https://goproxy.cn,direct以解决下载卡顿，还需检查goroot和path避免版本混淆，并通过go build验证实际构建能力。
GO111MODULE=on 没开，依赖管理直接失效
Go 1.11 引入 Modules 后，默认行为已变：不设 GO111MODULE 或设为 off 时，go mod 命令根本不会生效，go get 会退化回 GOPATH 模式——但你很可能没配 GOPATH，结果就是包下载失败、import 报错、go build 找不到依赖。
实操建议：
- 安装完 Go 后立刻执行
go env -w GO111MODULE=on（推荐）或在 shell 配置中加export GO111MODULE=on - 验证是否生效：
go env GO111MODULE输出必须是on，不是auto或空 -
auto模式只在项目根目录有go.mod时才启用，新手新建项目常忘了go mod init xxx，导致模块功能“看起来没用”
GOPROXY 没配，go get 卡死或超时
国内直连 proxy.golang.org 极不稳定，go get 经常卡在 “Fetching…” 或报 timeout 错误，新手容易误以为网络或命令写错，反复重试甚至重装 Go。
实操建议：
- 立即配置国内镜像：
go env -w GOPROXY=https://goproxy.cn,direct - 如果公司内网有私有代理，可设为
https://intranet-goproxy.example.com,direct - 注意末尾的
,direct：它保证私有域名（如公司内部 git 地址）绕过代理，否则go get gitlab.internal/pkg会失败
GOROOT 和 PATH 混淆，go version 显示旧版本
用 Homebrew 装了新 Go，但终端里 go version 还是显示老版本（比如 go1.19），说明系统仍优先调用旧路径的 go。常见于：手动装过旧版、双版本共存未清理、PATH 中 /usr/local/bin 在 /usr/local/go/bin 之前。
实操建议：
- 查真实路径：
which go和ls -l $(which go)看链接指向哪 - 确认
GOROOT是否被手动设错：go env GOROOT应该是/usr/local/go（macOS/Linux）或C:\Go（Windows），不是你的项目目录 - PATH 顺序关键：把
/usr/local/go/bin放在~/.local/bin或/usr/local/bin之前，避免旧版覆盖
没验证 go run 和 go build 的实际行为差异
新手常以为 go run main.go 成功 = 环境 OK，但生产部署靠的是 go build。如果 CGO 相关环境变量（如 CGO_ENABLED）或交叉编译目标（GOOS）没设对，go build 可能静默失败或生成无法运行的二进制文件。
实操建议：
- 首次搭建后，立刻跑：
go build -o testbin . && ./testbin，验证构建产物可执行 - 跨平台编译前先清掉本地缓存：
go clean -cache -modcache，避免旧平台对象污染 - 若项目用 SQLite 或 cgo 扩展，务必显式设
CGO_ENABLED=0再构建，否则容器里可能缺 libc
go env 的值、which go 的路径、go build 的产物能否直接运行，这三个点漏查一个，后续调试成本翻倍。golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
