go mod init 的模块路径必须严格匹配最终仓库地址，否则 go get 会失败或拉错代码；路径需与 git url 前缀一致、不含 .git 或分支名，v2+ 版本须在路径末尾加 /v2。
go mod init 初始化模块路径必须匹配最终仓库地址
模块路径不是随便起的，它直接决定别人 go get 时用什么导入路径。如果写成 github.com/yourname/mymodule，但实际仓库托管在 gitlab.company.com/team/mymodule，go get 就会失败或拉错代码。
常见错误现象：go get: module github.com/yourname/mymodule@v1.0.0 found, but does not contain package github.com/yourname/mymodule —— 本质是模块路径和 Git 仓库地址不一致，导致 Go 无法定位包。
- 初始化前先创建好远程仓库（GitHub/GitLab 等），再用该 URL 的域名+路径作为模块名执行
go mod init - 模块路径中不能含
.git后缀，也不能带分支名（如main） - 私有仓库场景下，模块路径应与
git clone地址前缀完全一致，例如gitlab.company.com/team/utils
导出函数/类型必须首字母大写且定义在可公开访问的包里
Go 的导出规则是硬性语法限制：只有包级变量、函数、类型等标识符以大写字母开头，才能被外部导入使用。小写开头的 hello() 或 config 在其他项目里根本不可见。
使用场景：别人执行 import "github.com/yourname/mymodule" 后，只能调用 mymodule.Hello() 这类大写开头的符号；内部逻辑封装用小写，避免暴露实现细节。
初始化并管理阿里云SDK Go 客户端，涵盖 sync.Once 单例、goroutine 安全、endpoint 与 region 配置、VPC 端点及调试。
- 确保
package mymodule（不是main）且文件不在internal/目录下 - 测试文件（
*_test.go）里的导出符号对外不可见，别指望靠它提供 API - 如果模块只含一个
main包，它无法被其他项目 import —— 这不是 bug，是设计使然
打 Git 标签必须指向含有效 go.mod 的 commit 并推送到远端
go get 不认本地 tag，也不认未 push 的 tag。标签必须真实存在于远程仓库，且对应 commit 中的 go.mod 文件必须存在、格式合法、路径正确。
容易踩的坑：git tag v1.0.0 后忘了 git push origin v1.0.0，或者标签打在没提交 go.mod 的旧 commit 上，结果 go list -m -versions 查不到版本，go get 默认 fallback 到 latest（即 HEAD），行为不可控。
- 确认当前分支已
git add . && git commit -m "release v1.0.0"，且go.mod已提交 - 执行
git tag v1.0.0（语义化版本，不要用1.0.0或ver1.0） - 必须运行
git push origin v1.0.0，仅git push不会推送 tag - v2+ 版本需在模块路径末尾加
/v2，例如module github.com/yourname/mymodule/v2，否则go get会报invalid version: module contains a go.mod file, so major version must be compatible
私有模块发布需配 GOPROXY + GONOPROXY + SSH 认证
公有模块走 GitHub 自动代理就行，私有模块必须让 Go 知道“哪些地址不走代理、怎么认证、要不要校验和”。缺一环就会卡在 go mod tidy 或 go build 阶段。
典型错误信息：go: gitlab.company.com/team/utils@v1.0.0: reading gitlab.company.com/team/utils/go.mod at revision v1.0.0: unexpected EOF —— 往往是 SSH 密钥没配好，或 GONOPROXY 没覆盖到完整域名前缀。
-
GOPROXY设为公司代理地址（如https://goproxy.company.com），末尾加,direct保底 -
GONOPROXY必须精确匹配模块路径前缀，例如gitlab.company.com/team，不能只写gitlab.company.com（若子路径多层） -
GOSUMDB=off是最简方案；若需校验，得自建 sumdb 或配置企业级服务 - 确保本地能
git clone git@gitlab.company.com:team/utils.git成功——这是go get底层依赖的同一套 SSH 机制
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
