答案是必须设go111module=on,否则go mod命令不触发、项目fallback到废弃gopath模式;go mod init仅创建空go.mod,需立即执行go mod tidy扫描import并补全依赖。

必须设 GO111MODULE=on,否则 go mod 命令根本不会触发,项目会 fallback 到已废弃的 GOPATH 模式,连 go.mod 都生成不了。
为什么 go mod init 后还不能正常构建
go mod init 只创建空的 go.mod,不下载任何依赖,也不检查 import 是否真实可用。此时直接 go build,大概率报错:找不到包、no required module provides package。
- 真正该做的是立刻执行
go mod tidy—— 它会扫描全部import行,自动补全直接/间接依赖,并写入go.mod和go.sum - 如果代码里写了
import "github.com/gin-gonic/gin"但没运行go mod tidy或go run,这个依赖就不会进go.mod - 别手动往
go.mod里加require行——go mod tidy下次运行会把它删掉
go get 不生效?先看 GO111MODULE 和 GOPROXY
国内常见现象:执行 go get github.com/sirupsen/logrus 卡住几秒后报 dial tcp: i/o timeout,或干脆无响应。
- 确认是否启用模块:
go env GO111MODULE输出必须是on;若为auto,在/tmp或非标准路径下极易失效 - 默认代理
https://proxy.golang.org国内无法直连,必须换镜像:go env -w GOPROXY=https://goproxy.cn,direct -
,direct很关键:它让私有仓库(如git.internal.company.com/lib)跳过代理,否则会因 401/404 报错
私有模块拉不下来?GOPRIVATE 必须配
没配 GOPRIVATE 时,Go 会把所有域名都当成公开模块,强制走 GOPROXY,结果对内网 Git 报 401 Unauthorized 或 404 Not Found。
- 设置方式:
go env -w GOPRIVATE="git.internal.company.com,github.com/myorg" - 支持通配符:
go env -w GOPRIVATE="*.company.com" - 验证是否生效:
go env GOPRIVATE应输出对应值;之后再go get私有地址就不会走代理了
最容易被忽略的是:模块模式不是“有 go.mod 就自动稳了”,环境变量才是开关。哪怕你 go mod init 成功、go.mod 文件存在,只要 GO111MODULE 是 auto 或 off,后续所有依赖操作都可能静默失败或行为异常。
golang免费学习笔记(深入):立即使用
在学习笔记中,你将探索golang的核心概念和高级技巧!











