go mod init 报“go.mod already exists”错是因为当前或父目录已存在go.mod文件；需检查路径、避免GOPATH/src下操作，强制初始化前应先删除旧文件并确保模块路径为合法域名格式。
go mod init 为什么报错 “go.mod already exists”
初始化模块时遇到这个错误，说明当前目录或父目录已有 go.mod 文件。Go 会向上查找最近的 go.mod，一旦找到就拒绝重复初始化。
- 用
go env GOPATH确认工作区路径，避免在$GOPATH/src下误操作（旧习惯易踩坑） - 检查隐藏文件：
ls -a | grep go.mod，有时go.mod在父目录里，cd进错层级就会触发该错误 - 想强制新建？先
rm go.mod（确认无误后），再运行go mod init example.com/myapp—— 模块路径必须是合法域名格式，否则后续go get会失败 - 模块名不是项目文件夹名：即使你在
/tmp/hello目录下，go mod init hello是错的；应写成go mod init example.com/hello
go.mod 里 require 和 replace 的实际作用差异
require 声明依赖版本约束，replace 是运行时重定向 —— 它不改变声明，只改下载和构建时的实际来源。
-
require github.com/sirupsen/logrus v1.9.3表示“我需要这个版本”，但若网络拉不到，或你想本地调试，就得加replace -
replace github.com/sirupsen/logrus => ./logrus-fix：指向本地目录，路径必须存在且含go.mod；若指向非模块路径，go build会报no Go source files -
replace不影响go list -m all输出的版本号，它只是“悄悄换源”；上线前务必删掉replace，否则 CI 环境找不到本地路径 - 跨版本替换要小心：
replace golang.org/x/net => github.com/golang/net v0.14.0可能因 fork 分支滞后引发 panic，建议优先用go get -u升级原依赖
go.sum 文件被修改是否需要提交
需要。它是依赖内容的校验快照，不提交会导致不同机器构建结果不一致，甚至编译通过但运行时报 missing module。
-
go.sum不是锁文件（不像package-lock.json），但它记录每个依赖及其子依赖的h1:校验和；只要go.mod改了、或执行了go get，它就可能变 - 常见误操作：手动删掉某行来“解决冲突”，这会让
go build拒绝加载该模块，报错checksum mismatch - 更新依赖后，用
go mod tidy自动同步go.mod和go.sum；不要只改一个 - CI 流程中加
go mod verify检查完整性，比单纯看文件是否存在更可靠
私有 Git 仓库依赖无法 go get 怎么办
Go 默认走 HTTPS，私有仓库常需 SSH 或自定义域名解析，得靠 git config 或环境变量配合。
立即学习“go语言免费学习笔记（深入）”；
- 先确保本地
git clone git@github.com:org/private.git能通；不通就别指望go get成功 - 配置 Git URL 重写：
git config --global url."git@github.com:".insteadOf "https://github.com/"，这样go get github.com/org/private实际走 SSH - 公司内网 GitLab？在
~/.gitconfig加[url "ssh://git@gitlab.example.com/"] insteadOf = https://gitlab.example.com/ - 若用 token 认证，把 token 塞进 URL：
go get https://token:x-oauth-basic@gitlab.example.com/org/private，但注意 shell 历史会留痕
replace 的临时性、go.sum 的不可省略性，这三点最容易在团队协作中被当成“小事”跳过，结果就是本地跑得通，CI 报错，上线 panic。 
