真正起作用的是 internal 目录机制：Go 编译器强制校验 import 路径中 /internal/ 的访问权限，仅允许其父级或同级模块导入，外部项目即使路径拼对也会编译报错；internal 必须是模块路径中完整一级，如 github.com/org/proj/internal/pkg 合法，而 github.com/org/proj/core/internal/pkg 无效。
如何让私有模块不被外部项目误引用
靠目录名或注释拦不住 import，真正起作用的是 internal 目录机制。Go 编译器在解析 import 路径时，一旦发现路径中包含 /internal/ 段，就会强制检查：当前 import 语句所在的模块路径，是否是该 internal 目录所在模块路径的**前缀**。如果不是，编译直接报错 import "xxx/internal/yyy" is not allowed。
-
internal必须是路径中完整的一段，myinternal或internal2都无效 - 它只对 import 起作用，对
go list、go mod graph等命令无限制 - 若子模块（如
service/order）想复用service/user/internal/logic，不行——因为service/order不是以service/user为前缀，会被拒绝 - 想共享逻辑？把公共部分抽到
pkg/下，用独立模块管理，再通过require引入
公共模块路径必须与 Git 地址严格对齐
你写 go mod init github.com/org/shared，就等于承诺：这个模块未来只能从 https://github.com/org/shared（或对应 SSH 地址）拉取。Go 不支持“路径别名映射”，go get 会按字面路径拼出 Git URL，失败就报 unknown revision 或 module not found。
- 如果仓库实际地址是
https://gitlab.example.com/group/lib，模块名就必须是gitlab.example.com/group/lib，不能是mylib.local - 用 SSH？确保
~/.gitconfig里配了[url "git@gitlab.example.com:"] insteadOf = https://gitlab.example.com/，否则go默认走 HTTPS 协议并卡住 - HTTPS 带 token？格式必须是
https://<token>:x-oauth-basic@gitlab.example.com/group/lib，且 token 需有读包权限；硬编码进go.mod是严重安全风险
开发阶段本地依赖怎么调试不踩坑
远程模块还没发版，但你要在主项目里试用新功能？别改 import 路径，用 replace —— 它只影响当前模块构建，不会污染下游。
Go 配置库，使用 spf13/viper — 分层优先级（flag > env >file > KV > default），提供 BindPFlag/BindPFlags、SetEnvPrefix + SetEnvKeyReplace 等功能。
- 在主模块的
go.mod里加：replace github.com/org/shared => ../shared（注意路径是相对于当前go.mod的） -
go mod tidy会自动把require行版本改成v0.0.0-00010101000000-000000000000，这是伪版本，表示“未打 tag 的本地快照” - 上线前必须删掉
replace，改用真实语义化版本号，否则 CI 构建会失败 - 多个 replace 共存时，Go 按文件中出现顺序应用，后写的会覆盖前面同路径的
为什么 GOPRIVATE 和 GOINSECURE 不能混用
GOPRIVATE 告诉 Go：“这些路径跳过代理和校验，但依然走标准 Git 协议，要认证”；GOINSECURE 是另一回事：“这些域名跳过 TLS 证书校验，仅用于自签名或内网 HTTP 服务”。两者职责不同，设错会导致拉不到代码或暴露凭据。
立即学习“go语言免费学习笔记（深入）”；
- 私有 GitLab？设
GOPRIVATE=gitlab.example.com，再配好 Git 凭据（git credential store或 SSH key） - 内网 HTTP 仓库（无 TLS）？设
GOINSECURE=git.internal.company，同时仍需GOPRIVATE=git.internal.company否则 go 会尝试走代理 - 设成
GOPRIVATE=*.company？不行，通配符不支持，必须列全域名或用逗号分隔
最易忽略的点：internal 只防 import，不防重构时的隐式耦合；replace 本地调试方便，但上线前漏删就是生产事故；GOPRIVATE 配错，CI 就卡在 go mod download。边界清晰靠设计，落地可靠靠检查。
