必须用 go mod init 且早于首次提交，因其生成的 go.mod 是可复现构建核心；模块路径须与 GitHub 地址一致；go.mod 和 go.sum 需一并提交；CI 中需禁用 GOPATH 并启用 module 模式。
初始化 Go 项目时该不该用 go mod init？
必须用，且要早于第一次提交。GitHub 本身不管理依赖，go mod init 生成的 go.mod 文件才是 Go 项目可复现构建的核心依据。
常见错误是先建空仓库、推代码、再补 go.mod，结果 CI 失败或他人 go build 报 no required module provides package。
-
go mod init github.com/username/repo—— 模块路径必须与 GitHub 仓库地址一致，否则go get无法正确解析 - 如果项目将来要发布为公共库，模块名不能以本地路径（如
./）或未注册域名开头 -
go mod tidy后记得提交go.mod和go.sum，二者缺一不可
GitHub Actions 中跑 Go 测试为什么总卡在 go test？
多数是因为没设 GOPATH 或没启用 module mode，尤其在旧版 Ubuntu runner 上默认仍走 GOPATH 模式。
正确做法是在 workflow YAML 中显式声明环境变量并指定 Go 版本：
env:
GOPATH: ""
GOCACHE: /tmp/.cache/go-build
steps:
- uses: actions/setup-go@v4
with:
go-version: '1.22'
- run: go test -v ./...
- 删掉
GOPATH环境变量（设为空字符串），强制 Go 使用 module 模式 - 避免用
go test ./...扫描所有子目录——如果有cmd/下多个 main 包，会报multiple main packages；改用go test ./... -exclude=cmd/或按包显式列出 - 测试超时常见于网络请求未 mock，建议加
-timeout 30s防止 CI 无限挂起
如何让别人用 go install 一键安装你的 CLI 工具？
关键不是 GitHub 设置，而是模块路径 + main 包位置 + tag 版本三者对齐。
