Go模块复用本质是控制依赖边界，通过import path显式声明、internal/硬隔离、go list验证流向；pkg/导出公共API，internal/存放私有实现，避免跨模块依赖cmd/main，版本需遵循语义化规范。
模块复用本质是控制依赖边界
Go 中没有“模块”语法关键字，module 是 go.mod 定义的版本化代码单元，复用的核心不是封装技巧，而是通过 import path 显式声明依赖、用 internal/ 隐藏实现、靠 go list 和 go mod graph 验证依赖流向。不加约束地导出包内所有符号，反而会破坏复用性。
用 internal/ 切割可复用与不可复用代码
把真正需要被其他模块引用的逻辑放在顶层包（如 github.com/yourname/lib/pkg），把仅服务于本模块的工具、mock、私有结构体移入 internal/ 子目录。Go 编译器会强制阻止外部模块 import internal/ 下的包 —— 这不是约定，是编译期硬限制。
-
pkg/：导出接口、核心函数、公开类型，例如pkg/cache提供NewRedisCache() -
internal/config/：只被本模块main或cmd/使用的配置解析逻辑 -
internal/testutil/：仅供本模块测试使用的 helper，外部无法 import
一旦误将本该放 internal/ 的代码放到 pkg/，后续升级时就不得不维护向后兼容，哪怕它本就不该暴露。
避免跨模块直接依赖 cmd/ 或 main 包
常见错误是让另一个模块 import github.com/yourname/app/cmd/somecmd 来复用其初始化逻辑。这会导致：依赖了未导出的 main 函数、绑定了特定 CLI 框架（如 spf13/cobra）、引入不必要的命令行 flag 初始化副作用。
立即学习“go语言免费学习笔记（深入）”；
正确做法是把可复用逻辑抽成独立包：
package main
import (
"github.com/yourname/app/core" // ← 复用点在这里
"github.com/yourname/app/internal/config"
)
func main() {
cfg := config.Load()
core.RunServer(cfg) // ← 启动逻辑下沉到 core/
}
这样其他模块只需 import core，无需关心命令行解析或 os.Exit() 等上下文。
版本兼容靠 go.mod 的 replace 和 require 精确控制
本地开发多模块协作时，别用 go get -u 自动升级，容易跳过中间兼容版本。用 replace 指向本地路径做联调，上线前再删掉：
replace github.com/yourname/lib => ../lib require ( github.com/yourname/lib v0.4.2 )
注意：v0.x.y 版本下任何 y 升级都可能含破坏性变更；v1.0.0 后才承诺语义化兼容。很多团队卡在 v0 多年，其实是没想清楚哪些 API 真正稳定可开放。
模块复用最难的不是写代码，是判断哪部分值得抽象、哪部分该锁死在内部。每次新增一个 exported 符号，都要问：这个类型/函数，未来 6 个月我敢保证不改签名吗？不敢，就先藏进 internal/。
