Go项目需先git init再go mod init，module路径必须与Git远程URL完全一致（含协议、大小写），go.sum必须提交，vendor/通常不提交，版本号用vMAJOR.MINOR.PATCH格式Git tag管理。
Go项目中如何初始化Git仓库并关联远程地址
环境搭好后，go mod init 只负责模块初始化，不自动建 Git 仓库。必须手动执行 git init，否则后续无法提交、打 tag 或参与 CI 流水线。
常见错误是直接在已有 Git 仓库里运行 go mod init，结果模块路径（如 github.com/xxx/yyy）和远程仓库地址不一致，导致 go get 拉取失败或依赖解析错乱。
- 先确认当前目录无
.git目录，再运行git init - 用
git remote add origin <url></url>关联远程地址，URL 必须与go.mod第一行的 module 名完全匹配（协议、域名、路径大小写都要一致） - 如果已存在不匹配的远程地址，用
git remote set-url origin <correct-url></correct-url>修正，而非删掉重加
go.mod 中 module 路径怎么写才不影响 Git 推送和依赖引用
module 路径不是随便起的别名，它就是 Go 的导入路径前缀，也是 Git 仓库的公开访问地址。写错会导致其他项目 import 失败，或 go list -m all 显示版本混乱。
例如你的 GitHub 仓库地址是 https://github.com/myorg/mycli，那么 go.mod 第一行必须是：module github.com/myorg/mycli —— 不能少 github.com/，不能写成 gitlab.com，也不能用本地路径如 ./mycli。
立即学习“go语言免费学习笔记（深入）”；
当用户提及 GitHub URL，或要求分析、审查、探索或理解任意 GitHub 项目、仓库或代码库时，请使用此技能。触发条件包括以下短语：“分析这个项目”、“看看这个仓库”、“analyze this repo”、“what does this project do”，或消息中包含任何 github.com URL。
- 首次
go mod init时直接传入正确路径：go mod init github.com/myorg/mycli - 若已初始化错，可手动编辑
go.mod第一行，然后运行go mod edit -module github.com/myorg/mycli同步校验 - 修改 module 路径后，所有内部 import 语句也得同步更新，IDE 通常能批量重命名，但命令行需手动 grep + sed
Git 提交时该不该提交 go.sum 和 vendor/ 目录
go.sum 必须提交，它是依赖哈希快照，不提交会导致不同机器 go build 时校验失败或静默降级；vendor/ 则取决于团队策略，但默认不建议提交。
Go 官方自 1.16 起默认启用 GO111MODULE=on，vendor/ 已非必需。提交它会显著增大仓库体积、拖慢 clone，并掩盖模块版本漂移问题。
- 确保
.gitignore包含/vendor（注意开头斜杠，避免忽略错名文件） - 如果因网络限制必须用 vendor，用
go mod vendor生成后提交，但每次go get后要重新运行该命令并检查 diff -
go.sum有变更必须提交，CI 流水线通常会校验go mod verify是否通过
如何用 Git tag 管理 Go 模块版本号
Go 模块版本依赖 Git tag，不是 package version 字符串。打错 tag 格式（比如漏掉 v 前缀）会导致 go get -u 找不到最新版，或 go list -m -versions 不显示。
合法 tag 必须符合 vMAJOR.MINOR.PATCH 格式，如 v1.2.0、v0.5.3。预发布版本可用 v1.2.0-beta.1，但不能用 1.2.0 或 release-1.2.0。
- 打 tag 前先
git commit -am "chore: prepare v1.2.0"，再git tag v1.2.0 - 推送时用
git push origin v1.2.0（只推单个 tag），或git push origin --tags（推全部，慎用） - tag 推送后，其他项目才能通过
go get myrepo@v1.2.0精确拉取，且go list -m -u会提示可升级
最容易被忽略的是 module 路径与 Git 远程 URL 的严格一致性——它们不是“看起来像就行”，而是 Go 工具链逐字符比对的。一个斜杠、一个大小写、甚至 HTTPS 和 SSH 协议混用，都会让依赖管理失效。
