Go 1.22+ 默认启用模块模式，GOPATH不再是硬性要求；但go mod行为变化、gopls版本兼容性及GOPROXY配置失效是新人常见卡点，需强制GO111MODULE=on、校验GOMOD路径、重装gopls并修正GOPROXY为逗号分隔且direct置末。
Go 1.22+ 默认启用模块模式，不再需要 GOPATH 目录结构；但 go mod 行为变化、gopls 版本兼容性、以及 GOPROXY 配置失效是当前最常卡住新人的三处。
go mod init 后为什么 still in GOPATH mode？
这是典型的新旧混合配置残留：系统仍读取了旧版 GO111MODULE 环境变量或项目根目录下存在 vendor/ 或 GOPATH/src/ 路径干扰。
- 执行
go env -w GO111MODULE=on强制开启模块模式（2026 年已默认，但旧 shell 配置可能覆盖） - 检查当前目录是否在
$GOPATH/src下——如果是，go mod init会静默退化为 GOPATH 模式 - 删掉项目里残留的
vendor/目录再试，否则go build会优先读 vendor 而非 proxy - 运行
go env GOMOD，输出应为项目根目录下的go.mod绝对路径；若为空，说明未真正进入模块模式
gopls 报错 “requires go >= 1.21” 却已装 1.25？
gopls 不读取全局 go version，而是依赖 VS Code 中配置的 Go 二进制路径，且不同 VS Code 扩展版本绑定的 gopls 最低 Go 版本不同。常见于手动升级 Go 后未重装工具链。
- 在 VS Code 中打开任意
.go文件，底部状态栏点击gopls→ “Install All Tools” - 若失败，手动运行：
go install golang.org/x/tools/gopls@latest（注意不是@stable） - 确认 VS Code 设置中
go.gopath已清空（新版不再需要），改用go.toolsGopath也应留空 - 检查
gopls -version输出，确保其 go version 字段 ≥ 当前 Go 版本，否则说明它链接的是旧GOROOT
GOPROXY=https://goproxy.cn,direct 突然不生效？
2026 年起，goproxy.cn 已停止维护，官方推荐切换至 https://proxy.golang.org（需科学访问）或国内可用替代如 https://mirrors.cloud.tencent.com/go/。更关键的是，direct 位置错误会导致 fallback 失效。
立即学习“go语言免费学习笔记（深入）”；
- 正确写法：
go env -w GOPROXY=https://mirrors.cloud.tencent.com/go/,https://proxy.golang.org,direct - 逗号分隔多个代理，
direct必须放在最后，且前面不能有空格 - 执行
go env GOPROXY确认输出无引号、无换行、无多余空格 - 若公司内网有私有代理，需额外设置
go env -w GONOSUMDB=*.your-company.com避免校验失败
真正麻烦的不是安装步骤，而是那些没报错却默默走错路径的情况——比如 go list -m all 显示的模块版本和 go.mod 里写的不一致，往往是因为本地 replace 规则被 IDE 缓存忽略，或者 go.work 文件在父目录中悄悄启用了多模块工作区。
