GO111MODULE=on是强制前提，必须显式启用；GOPRIVATE需精确匹配模块路径前缀（如gitlab.example.com/**），多域名用英文逗号分隔无空格；module path须与仓库地址严格一致，否则checksum mismatch；git认证失败是根本瓶颈，Go仅跳过代理但依赖git命令拉取。
GO111MODULE=on 是前提，不是可选项
Go 1.16+ 虽默认开启模块模式，但 CI 镜像、Docker 容器或旧 shell 配置常覆盖为 auto 或 off。一旦是 auto，在 /tmp 或非 GOPATH/src 下执行 go mod init 可能直接失败；off 则让 go mod 命令完全失效，go build 报 no required module provides package。
必须全局显式启用：
go env -w GO111MODULE=on- 不要依赖项目目录位置判断是否启用模块
- 新建项目时，直接在空目录运行
go mod init gitlab.example.com/team/project，module path 必须与未来仓库地址一致（不能是cmd或本地绝对路径）
GOPRIVATE 必须精确匹配模块路径前缀
GOPRIVATE 不是“告诉 Go 去哪拉代码”，而是“告诉 Go 别把这段路径当公共模块处理”——它触发 GONOPROXY 和 GONOSUMDB 的自动行为。写错就卡在 unknown revision 或 404 Not Found。
Colly Golang Web Scraper and Crawler Framework
下载
Colly 是一个用于 Go 语言的快速开源爬取和爬虫框架。它适用于从简单的页面提取到异步爬虫处理大量页面集合，支持请求回调和结构化解析。
- 错误写法：
GOPRIVATE=*.example.com（Go 不支持域名通配） - 错误写法：
GOPRIVATE=gitlab.example.com/（缺通配符，无法匹配子路径） - 错误写法：
GOPRIVATE="gitlab.example.com/**, gitee.com/my-team/*"（逗号后空格导致 Linux/macOS 截断） - 正确写法：
go env -w GOPRIVATE="gitlab.example.com/**,gitee.com/my-team/*" -
**匹配任意深度子路径（推荐），*只匹配一级；多域名严格用英文逗号分隔、无空格
git 认证失败才是真瓶颈，Go 不管这事
设置了 GOPRIVATE 后，Go 会跳过代理和校验，但实际拉代码的是系统 git 命令。如果 git clone https://gitlab.example.com/team/project 失败，go get 一定失败。
立即学习“go语言免费学习笔记（深入）”；
- HTTPS 方式：用 Personal Access Token 配置
~/.netrc，或设git config --global credential.helper store - SSH 方式：确保
ssh-agent已加载私钥，且远程仓库已绑定公钥；~/.gitconfig中建议加[url "git@git.example.com:"] insteadOf = https://git.example.com/避免协议冲突 - 自签名证书场景：
GOINSECURE=git.example.com仅限开发环境；生产应把内网 CA 加入系统信任链，或通过git config --global http."https://git.example.com/".sslCAInfo /path/to/ca.crt指定 CA
module path 与仓库地址必须对齐，否则 checksum mismatch
Go 不允许“路径自由映射”。go.mod 中的 module 声明（如 gitlab.example.com/group/lib）必须能被解析为真实 Git URL。否则 go mod download 报 unknown revision 或 module not found。
- 仓库 HTTPS 地址是
https://gitlab.example.com/group/lib→module必须是gitlab.example.com/group/lib - 若用 SSH（
git@gitlab.example.com:group/lib.git），需确保git config中有insteadOf规则，否则 Go 默认走 HTTPS 协议并失败 - 不支持纯路径（如
mylib）或本地别名（如mylib.local），必须含域名（哪怕用git.internal这类假域名） -
replace是开发期临时方案，上线前必须删掉；它不传递给下游，CI 环境无对应本地路径就会构建失败
GOPRIVATE 少个星号、git 凭据没生效、证书没装进系统信任链——任一环节断开，go mod tidy 就停在第一行私有依赖上。 
