go项目版本控制必须将git与go模块机制、工作区结构深度整合，否则易在构建测试阶段报错；git仓库根目录须与go模块根目录一致，gitignore需排除非源码文件，tag而非分支承载语义化版本，ci需处理shallow clone和生成文件问题。
Go 项目做版本控制，必须用 Git，但不能只当“提交按钮”来用——它和 Go 的模块机制、工作区结构、团队协作节奏深度耦合，漏掉任一环都容易在 go build 或 go test 阶段突然报错。
Git init 前先确认 GOPATH / Go Modules 状态
很多人在空目录下直接 git init，结果后续 go mod init 出现路径不一致、go get 拉不到本地依赖等问题。根本原因是：Git 仓库根目录 ≠ Go 模块根目录 ≠ GOPATH/src 子路径（如果还在用 GOPATH 模式）。
- 如果你用 Go Modules（推荐且默认），
go mod init example.com/myapp必须在项目根目录执行，这个目录也应是git init的位置；否则go.sum记录的校验和会和实际文件树错位 - 如果仍用 GOPATH 模式，项目必须放在
$GOPATH/src/example.com/myapp下，git init也要在这个子目录里，否则go install找不到可执行入口 -
.gitignore必须包含/bin、/pkg（GOPATH 模式）、go.work（多模块工作区）、以及所有*.exe和*.test—— 这些不是源码，不该进仓库
分支策略要匹配 Go 的发布语义
Go 项目没有“编译产物版本号”，版本全靠 go.mod 里的 module 行和 tag 决定。这意味着：分支名本身不携带语义，但 git tag 必须严格对应 go.mod 中声明的模块路径和语义化版本。
Go语言（Golang）1.26.0版本提供 Go 官方 Windows amd64 MSI 安装包下载入口，版本号 1.26.0，可用于旧项目维护、兼容性测试和指定版本开发环境配置。
- 不要用
git checkout -b v1.2.0这种分支——tag 才是 Go 生态认的版本，分支只是开发中转站 - 打 tag 前务必检查
go.mod第一行是否为module example.com/myapp，且当前 commit 已go mod tidy清理干净；否则下游go get example.com/myapp@v1.2.0会拉到不一致的依赖树 - 主干建议用
main（不是master），因为 Go 官方工具链（如go list -m all）默认识别main分支为“最新不稳定版”
go-git 库调用时绕不开的引用解析陷阱
用 github.com/go-git/go-git 在代码里操作仓库，看似封装了命令行，实则暴露了 Git 底层对象模型。最常踩的坑是误把工作区路径当仓库路径，或混淆 HEAD 和 refs/heads/main。
-
git.PlainOpen("/path/to/project")要求传入的是仓库根（含.git/目录的父目录），不是任意子目录；否则报repository not found - 读取当前分支名别直接解析
.git/HEAD文件内容——它可能是ref: refs/heads/main，也可能是 detached HEAD 的哈希值；要用r.Reference(&git.PlainOpenOptions{}).Name()安全获取 - 写入新 commit 前，确保暂存区已通过
w.Index().Commit()提交，否则git log看不到，go mod download也无法按 commit hash 拉取
CI 流水线里 go test 失败常因 git clean 不彻底
很多 CI 脚本用 git clone --depth=1 加速，但 Go 的测试可能依赖未跟踪的生成文件（如 pb.go）、或 go generate 产出物。这些在 shallow clone 下根本不存在。
- CI 中运行
go test前，加一句git fetch --unshallow 2>/dev/null || true，避免因缺少历史而让go list -mod=readonly报错 - 如果项目含
//go:generate，务必在go test前跑go generate ./...，且确保.gitignore没把生成文件排除——否则本地能过，CI 必挂 - 交叉编译场景下（如
GOOS=linux go build），注意git status显示的 “modified” 文件可能被 Go 构建缓存忽略，但go test -count=1会强制重编，导致行为不一致
Git 对 Go 项目来说，从来不只是记录“谁改了哪行”。它和 go.mod 的哈希锁定、go.work 的多模块协调、CI 中的构建缓存生命周期，全都咬合在一起。一个 git reset --hard 可能让你的 go run main.go 突然找不到包，这不是 Git 的问题，是你没把它当成 Go 构建系统的一部分来看待。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
