模块路径应使用项目最终公开URL（如github.com/username/projectname），避免本地路径、无命名空间简名、大小写/下划线；GO111MODULE=on在Go 1.16+非必需但推荐显式设置；“no required module”错误需检查import拼写、replace/exclude、module声明与目录一致性；私有模块需配.gitconfig凭据+GOPRIVATE+必要时GONOSUMDB/GOINSECURE。
go mod init 时模块路径怎么写才不会踩坑
模块路径不是随便起个名字就行，它直接影响后续依赖解析、版本发布和他人导入方式。最稳妥的做法是用项目最终的公开 URL 路径（即使还没托管），比如 GitHub 仓库地址去掉协议和域名后缀：github.com/username/projectname。
常见错误包括：
- 用本地路径如
/home/user/myproj——go build会报cannot find module providing package - 用
myproject这类无命名空间的简名 —— 后续发布到私有代理或升级 Go 版本时易冲突 - 路径含大写字母或下划线 —— Go 官方工具链虽支持，但部分 CI/CD 或 proxy 服务会转成小写导致 404
如果项目暂不公开，也建议模拟一个合理路径，例如 example.org/internal/mytool，避免后期迁移重写所有 import 语句。
GO111MODULE=on 是必须打开的吗
Go 1.16+ 默认启用模块模式，GO111MODULE 环境变量已过时；但如果你在 GOPATH/src 下开发旧项目，或某些 CI 环境仍用 Go 1.15 及更早版本，就仍需显式设置。
立即学习“go语言免费学习笔记（深入）”；
判断是否生效最直接的方式是运行：
go env GO111MODULE
输出 on 才代表模块模式激活。若为 auto，在非 GOPATH 且含 go.mod 的目录下也会启用，但行为不稳定 —— 建议统一设为 on：
export GO111MODULE=on
注意：Windows 用户用 set GO111MODULE=on（cmd）或 $env:GO111MODULE="on"（PowerShell）。
go mod tidy 报错 “no required module provides package” 怎么定位
这个错误本质是 Go 找不到某个 import 路径对应的模块定义，不是网络问题，而是模块路径与实际代码结构不匹配。
排查顺序如下：
- 检查出错的
import路径是否拼写错误，比如github.com/user/pkg/v2写成github.com/user/pkg/v3 - 确认该路径是否已在
go.mod中被replace或exclude，导致无法解析 - 查看
go.mod第一行的module声明，是否和当前项目根目录不一致（例如module example.com/foo，但你在./bar子目录下执行go mod tidy） - 运行
go list -m all | grep -i xxx快速确认某模块是否被加载
临时绕过可加 -e 参数，但只是掩盖问题，不解决根本原因。
私有模块（GitLab / 自建 Nexus）怎么让 go mod 正常拉取
Go 不会自动走 SSH 或自定义 Git 配置，必须明确告诉它如何解析私有域名。
核心配置分两步：
- 在
~/.gitconfig中配好对应域名的 SSH 或 HTTPS 凭据（尤其注意 GitLab 的gitlab.example.com要和go.mod里 import 路径完全一致） - 在
go env -w中设置GOPRIVATE，例如：go env -w GOPRIVATE=gitlab.example.com,mycompany.internal
，否则 Go 会尝试走公共 proxy 并失败
如果公司用 Nexus 或 Artifactory，还需额外配置 GONOSUMDB 和 GOINSECURE（仅限内网可信环境），否则校验和检查会拦截私有源。
验证是否生效：删掉 go.sum 和 pkg/mod/cache 对应目录，再跑一次 go mod download，看是否走的是你预期的 Git 地址而非 proxy。
