必须重发新tag，不能只改本地go.mod或远程URL；需用go mod edit -module更新路径、批量替换import语句、提交后打全新tag（如v2.0.0），旧tag不可复用。
go.mod 中 module 路径写错了，但代码已推到远程仓库怎么办
必须重发新 tag，不能只改本地 go.mod 或远程 URL。Go 的 checksum database（sum.golang.org）按模块路径+版本哈希锁定，路径一错，所有已有 tag 都失效。
- 用
go mod edit -module new.example.com/team/proj更新go.mod第一行，新路径需能被解析（HTTPS 可访问、有 Git 服务） - 批量替换全部
import语句：比如把import "github.com/olduser/proj/pkg"改成import "new.example.com/team/proj/pkg" - 提交变更后，打全新 tag（如
v2.0.0），旧 tag 不可复用 —— Go 不允许同一 tag 对应不同模块路径 - 若想提示旧路径用户迁移，可在旧仓库根目录放一个仅含
module github.com/olduser/proj的go.mod，加注释说明，但这不解决实际依赖问题
本地 import 写成 "./pkg" 或 "pkg" 导致 cannot find package
Go 模块下 import 路径不是文件系统路径，而是「模块名 + 子路径」。写相对路径或短名会直接报错，且 IDE 和命令行行为一致。
- 确认
go.mod第一行是module example.com/myapp，那么./pkg/utils目录的合法 import 就是"example.com/myapp/pkg/utils" - 不要用
import "./pkg/utils"或import "utils"—— 前者违反模块规则，后者会被判为无 hostname 的非法路径 - 子包无需单独
go mod init，整个项目共用一个模块，go mod tidy会自动识别并补全依赖 - VS Code 提示找不到包？检查是否以含
go.mod的目录为工作区根，并执行Go: Restart Language Server
私有 Git 仓库路径含大小写或子组，导致 go get 失败
Go 对模块路径大小写敏感，且路径必须与远程仓库 URL 完全一致（包括斜杠、大小写、子组层级）。GitLab 或自建 Git 常见漏掉中间层级。
- 仓库地址是
https://gitlab.example.com/group/subgroup/repo，则go.mod中必须写module gitlab.example.com/group/subgroup/repo - 路径中任意字母大小写不一致（如
MyRepovsmyrepo）都会触发checksum mismatch - 私有域名必须配置
GOPRIVATE：运行go env -w GOPRIVATE="gitlab.example.com"，否则 Go 会试图走GOPROXY导致 401/404 - 若用自定义域名（如
mycorp.internal/lib），需确保 DNS 可解析、HTTPS 可访问，并在根路径提供go-importmeta 标签，否则go get直接失败
replace 本地路径后构建失败或 CI 报错
replace 是临时开发手段，对路径合法性、目标模块结构、环境一致性要求极高。CI 环境尤其容易因路径失效而中断。
立即学习“go语言免费学习笔记（深入）”；
-
replace github.com/u/lib => ../lib中的../lib必须是含有效go.mod的目录，且其module行必须与 replace 左侧完全一致（含大小写） - CI 中禁止使用相对路径
=> ../lib—— 构建目录结构不同，路径会崩。应改用 commit hash 替代：replace github.com/u/lib => git@github.com:u/lib.git v0.1.0-xxx -
replace不传播给下游依赖，上线前必须删除该行，否则他人go get时会因找不到../lib报错 - 目标目录若无
go.mod，Go 会 fallback 到 legacy mode 解析，极易引发no required module provides package
