来源：械说
在Go语言中，Go 项目工程化：项目结构与模块划分是打造可维护、高可扩展应用的关键一环。本章重点围绕目录组织、模块划分、代码职责清晰度、业务解耦等方面进行实战讲解。
一、为什么需要项目结构与模块划分？
随着项目规模变大、多人协作需求上升，如果代码结构混乱，容易出现：
- o 重复造轮子
- o 耦合度高、无法复用
- o 不易测试、维护成本高
- o 项目目录混乱，难以 onboarding
二、Go 工程常见结构方案1. 单体项目结构（适合小项目）project/├── main.go├── handler/├── service/├── model/├── config/├── util/└── router/
- o main.go：程序入口
- o handler/：HTTP 请求处理层
- o service/：业务逻辑层
- o model/：数据库模型
- o config/：配置管理
- o util/：工具函数
- o router/：路由注册
2. 分层架构结构（推荐中大型项目）project/├── cmd/ // 主程序入口目录（多个服务）│ └── app/│ └── main.go├── internal/ // 内部私有逻辑│ ├── handler/ // 控制器层│ ├── service/ // 业务层│ ├── repo/ // 数据存储层（DAO）│ └── domain/ // 领域模型（实体定义）├── pkg/ // 可复用的包（公共库）├── api/ // OpenAPI 或 proto 接口定义├── configs/ // 配置文件├── scripts/ // 初始化脚本├── test/ // 测试辅助文件├── go.mod└── README.md
优点：
- o 目录清晰，分工明确
- o 支持多个服务共用一套逻辑
- o internal/ 私有，防止外部导入
三、模块划分实战指南
Go 鼓励将代码按“功能”而非“技术”组织。例如：
/internal/user/├── handler.go// 用户请求处理├── service.go// 用户业务逻辑├── model.go// 用户模型定义├── repository.go// 用户数据访问
以“用户模块”为核心，一套功能下集中各层实现，避免跨模块调用混乱。
四、工程化设计建议
- 建议
- 说明
- 以领域划分模块例如 user、order、product 模块独立
- interface 定义解耦在 service、repo 中定义接口，便于 mock 测试
- internal/ 与 pkg/ 分开internal/ 私有不可被其他模块引入
- cmd/ 启动多服务程序入口支持多个 main.go，例如 admin、api、worker
- 使用配置中心管理 config支持环境变量、yaml、dotenv 配置
- 工具与中间件放在 pkg/可复用的 redis、logger、validator 等库
五、实践示例：一个中型商城项目结构go-mall/├── cmd/│ └── api/ # 网关入口服务├── internal/│ ├── user/ # 用户模块│ ├── product/ # 商品模块│ ├── order/ # 订单模块│ └── middleware/ # 中间件封装├── pkg/│ ├── logger/ # 日志封装│ └── config/ # 配置加载├── api/│ └── proto/ # gRPC 定义├── configs/ # 配置文件├── scripts/ # 脚本工具├── go.mod└── README.md
六、结语
良好的项目结构不仅是“代码好看”，更是：
- o 解耦分层，易扩展
- o 便于测试与维护
- o 支持多人协作与分工
随着项目成长，还可结合微服务、DDD（领域驱动设计）、Hexagon 架构等进行更深度演化。