Go模块优化核心是职责单一、边界清晰、依赖可控：按业务域（如user、payment）而非技术层组织包；接口由调用方定义并置于使用包内；用internal限制访问；严控第三方依赖；通过适配器封装SDK；持续审视依赖关系。
在 Go 中优化模块结构，核心是让每个模块职责单一、边界清晰、依赖可控。Go 本身没有强制的包管理规范，但通过合理设计目录结构、控制导入关系、拆分接口与实现，能显著降低耦合和维护成本。
按业务域而非技术层组织包
避免常见的 controller、service、repository 顶层平铺结构。这种分法容易导致跨域引用泛滥、循环依赖，且业务逻辑被割裂。应以功能或领域为单位划分包，例如：user、payment、notification，每个包内再按需组织内部结构（如 user/model、user/adapter、user/usecase）。
- 对外暴露的类型和函数尽量放在包根目录，内部实现细节下沉到子包（如
user/internal） - 不同业务包之间禁止直接导入对方的内部实现，仅通过定义好的接口或 DTO 通信
- 共享基础类型（如 ID、TimeRange）可提取到
pkg/domain或internal/model，但避免变成“万能工具包”
用接口隔离依赖，延迟具体实现绑定
依赖倒置是解耦关键。让高层模块（如 usecase）依赖抽象接口，而非底层模块（如 database 或 http client）的具体类型。接口应由调用方定义，放在使用它的包里，而不是被调用方。
- 例如
user/usecase定义type UserRepository interface { GetByID(id ID) (*User, error) } - 真实数据库实现放在
user/adapter/postgres，只导入user/usecase接口，不反向依赖 - 避免在接口中塞入未被当前用例使用的函数（接口污染），必要时可按场景拆分小接口
严格管控外部依赖引入
每个包只引入真正需要的第三方库，且优先使用 Go 标准库或轻量替代品。避免因一个包引入整个框架（如全量 github.com/gin-gonic/gin）导致编译慢、升级风险高。
立即学习“go语言免费学习笔记（深入）”；
- HTTP 路由、中间件等基础设施代码统一收口到
cmd/或app/层，业务包不直接 import gin/echo/fiber - 对 SDK 类依赖（如 AWS、Stripe），封装成适配器包（
infra/aws），提供简单接口，屏蔽 SDK 内部复杂性 - 定期运行
go mod graph | grep 'your-module'检查是否有意外的间接依赖穿透到业务层
善用 Go 的 visibility 规则和 internal 包
利用首字母大小写控制导出范围，并主动用 internal/ 目录限制跨模块访问。这是 Go 原生支持的强约束机制，比文档约定更可靠。
- 把仅供本模块内部使用的工具函数、配置结构体、中间类型放在
internal/子目录下 - 如果某包只被同级其他包使用（如
user/adapter只被user/usecase使用），可考虑合并或设为user/internal/adapter - 避免在
internal/中放置会被测试文件（_test.go）以外代码引用的类型——测试文件可以读internal，但生产代码不能
不复杂但容易忽略：模块优化不是一蹴而就的重构，而是日常编码中的持续判断——这个函数该放哪？这个 import 是否必要？这个接口是不是太胖了？每次提交前花 30 秒审视依赖线，长期下来结构自然清晰。
