Go module 的 replace 仅本地生效，用于将 import 路径映射到本地或非标准位置，不修改源码 import 语句，需配合 go mod tidy 或 go build 更新 go.sum，且目标目录须含合法 go.mod。
Go module 的 replace 能改导入路径，但只在本地生效
自定义包导入路径不是改 import 语句本身，而是让 Go 工具链把某个 import path 映射到本地或非标准位置的代码。最常用也最安全的方式是用 go.mod 里的 replace 指令。
它不改变源码中的 import "github.com/user/repo"，而是在构建时把对该路径的所有引用重定向到指定目录或 commit。
-
replace只影响当前 module，对依赖它的其他项目无效 - 必须配合
go mod tidy或go build触发更新go.sum - 如果目标路径是本地目录，该目录下必须有合法的
go.mod（哪怕只是空文件） - 别用
replace指向未初始化 git 的目录，Go 会报invalid version: unknown revision
replace github.com/old/pkg => ./local-pkg
想让别人也用你的自定义路径？得靠 go get + GOPROXY 或私有模块代理
单纯改自己机器上的 replace 或 go env -w GOPATH 对协作毫无意义。真要统一使用非标准路径（比如内部服务用 corp/internal/util），必须让 Go 工具能“解析”这个路径——核心是控制模块发现逻辑。
- Go 默认只认 HTTPS + git 协议的公开路径；
corp/internal/util这种不会自动找本地文件系统 - 设置
GO111MODULE=on是前提，否则go get可能退化为 GOPATH 模式，行为不可控 - 通过
go env -w GOPROXY="https://proxy.golang.org,direct"配合私有代理（如 Athens），才能把corp/...映射到内部 git 地址 - 若不用代理，可临时用
go get corp/internal/util@v0.1.0，但要求该路径对应一个真实可 clone 的仓库（如ssh://git@internal/corp/internal.git），且需配置~/.netrc或 git credential
import 语句里写相对路径？Go 直接报错
有人试过在代码里写 import "./mylib" 或 import "../shared"，Go 编译器会立刻拒绝：
立即学习“go语言免费学习笔记（深入）”；
local import "./mylib" only allowed in 'main' package
这不是限制，而是设计原则：Go 的 import path 必须全局唯一、可寻址、可复现。相对路径破坏了模块可移植性。
- 连
main包里都不建议用相对 import，它绕过 module 系统，无法被go list或 IDE 正确索引 - 如果只是想组织本地代码，正确做法是：在子目录里初始化独立 module（
go mod init myproj/sub），然后用标准路径import "myproj/sub"，再通过replace指向本地 - IDE（如 VS Code + gopls）依赖 import path 做符号跳转，乱写路径会导致跳转失效、补全失灵
CI/CD 中 replace 失效？检查 go mod download 是否跳过了本地映射
本地跑得好好的 replace，一上 CI 就找不到包，常见原因是 CI 环境没同步本地修改，或用了缓存导致 go.mod 未重新解析。
- CI 脚本里别只跑
go build，先执行go mod download看是否报错；它会强制校验所有依赖，包括replace目标 - 如果
replace指向 Git commit，确保 CI 机器能访问对应仓库（私有 GitLab 需提前配置 SSH key 或 token） - Docker 构建时，
replace路径如果是./local，必须把该目录 COPY 进镜像，且路径要和go.mod里写的完全一致（区分大小写、斜杠方向） - 某些 CI 使用 vendor 模式（
go mod vendor），此时replace不生效——vendor 里只存最终解析后的代码，不保留重定向逻辑
