私有仓库打tag前必须确保go.mod路径与仓库地址严格一致，如gitlab.example.com/team/utils；否则go get将报错no required module provides package或unknown revision。
私有仓库打 tag 前必须确保 go.mod 路径与仓库地址一致
Go 模块系统不验证域名是否可访问，但严格依赖 module 声明的路径格式。如果你的私有仓库地址是 gitlab.example.com/team/utils，那初始化时必须运行：
go mod init gitlab.example.com/team/utils
而不是 go mod init utils 或 go mod init ./utils——后者会导致 go get 报错 no required module provides package。
常见错误：
- 本地
go.mod里写的是module gitlab.example.com/team/utils，但仓库实际托管在https://gitlab.example.com/group/subgroup/utils，路径不匹配 → 其他项目go get时解析失败 - 改过一次
module名称后又打 tag，旧导入路径（如import "gitlab.example.com/team/utils"）将无法再解析到新版本
发布 v1.0.0 之前要理解 /v1 后缀规则
Go 对 major 版本有硬性路径约束：v1.x 系列模块必须在 import path 末尾显式加 /v1，否则其他项目 go get 会报 invalid version: module contains a go.mod file, so major version must be compatible。
正确做法分两步：
- 先确保当前
go.mod中仍是module gitlab.example.com/team/utils（对应 v0.x） - 打第一个 v1 tag 前，把
go.mod改成module gitlab.example.com/team/utils/v1，再提交、push、git tag -a v1.0.0 -m "first v1 release"，最后git push origin v1.0.0
注意：v0.9.0 和 v1.0.0 是两个完全独立的模块路径，不能混用 import 语句。
初始化并管理阿里云SDK Go 客户端，涵盖 sync.Once 单例、goroutine 安全、endpoint 与 region 配置、VPC 端点及调试。
打完 tag 必须 push 到远端，且 tag 指向含 go.mod 的 commit
git tag v1.0.0 只是本地操作，go get gitlab.example.com/team/utils@v1.0.0 会直接失败，报 unknown revision v1.0.0 或 unrecognized import path。
验证是否成功发布的最简方式：
- 执行
go list -m -json gitlab.example.com/team/utils@v1.0.0 - 输出中必须包含
"Version": "v1.0.0"且不是(devel) - 如果提示
reading https://gitlab.example.com/team/utils/@v/v1.0.0.info: 404 Not Found，说明 tag 没 push，或仓库未开启 package registry 功能（GitLab/Gitea 需额外配置）
私有模块升级不能靠改本地文件，必须走 go get + tag
很多人在本地改了私有包代码，然后跑 go mod tidy，发现主项目没更新——因为 Go 模块系统只认 go.mod 中 require 行声明的版本，不感知本地文件变更（除非用了 replace）。
正确升级流程：
- 进入私有模块目录，提交变更，打新 tag：
git tag v0.2.0 && git push origin v0.2.0 - 回到主项目目录，运行：
go get gitlab.example.com/team/utils@v0.2.0 - 再执行
go mod tidy，确认go.mod中require行已更新，且go.sum新增对应校验行
容易被忽略的一点：如果私有仓库用 HTTPS，且未配置 GOPRIVATE，go get 会尝试走代理并校验 checksum，结果卡在 x509 certificate signed by unknown authority 或 404 Not Found——此时必须提前设置 go env -w GOPRIVATE="gitlab.example.com/**"。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
