Go语言无内置MVC框架,但可通过包组织、接口抽象和职责划分实现:Model专注数据与业务规则,Controller协调请求与响应,View仅负责模板渲染或序列化。

Go 语言本身没有内置 MVC 框架(不像 Ruby on Rails 或 Laravel),但完全可以通过包组织、接口抽象和职责划分来清晰实现 MVC 模式。关键不在于框架,而在于逻辑分层意识和松耦合设计。
模型(Model):专注数据与业务规则
Model 层负责数据结构定义、数据库操作、校验逻辑和核心业务规则,不依赖 HTTP、路由或模板。通常放在 model/ 目录下:
- 用 struct 定义领域实体(如
User、Post) - 将数据库操作封装为方法(如
user.Save()或独立的userRepo.Create()) - 避免在 Model 中写日志、HTTP 状态码、JSON 序列化等表现层逻辑
- 可引入接口抽象仓储(Repository),便于单元测试和替换数据源
控制器(Controller):协调请求与响应
Controller 是 HTTP 请求的入口,负责接收参数、调用 Model 处理业务、决定返回什么视图或数据。它不处理数据细节,也不渲染 HTML:
- 每个 handler 函数只做三件事:解析输入(query/path/form)、调用 Model 方法、构造响应(调用 View 或直接 JSON 返回)
- 推荐使用结构体绑定 controller,便于依赖注入(如传入 *UserRepository)
- 错误统一转为 HTTP 状态码,不把数据库错误直接暴露给前端
- 例如:
func (c *PostController) Show(w http.ResponseWriter, r *http.Request)中只调post, err := c.repo.FindByID(id),然后交给 View 渲染或返回 JSON
视图(View):纯模板渲染,无逻辑
View 层仅负责将数据转换为客户端可读格式(HTML、JSON、XML),禁止包含 if/for 以外的业务判断:
立即学习“go语言免费学习笔记(深入)”;
- HTML 模板放在
templates/目录,用html/template加载 - Controller 把结构体(如
map[string]interface{}或专用 ViewModel)传给模板,模板只做字段渲染和简单循环 - JSON 响应可直接用
json.NewEncoder(w).Encode(data),无需额外“View”文件,此时 View 即序列化动作本身 - 避免在模板里调用函数查数据库、计算状态——这些必须前置到 Controller 或 Model
实际项目结构建议
一个轻量但清晰的目录组织示例:
-
main.go—— 启动入口,注册路由 -
controller/—— 各资源控制器(user_controller.go) -
model/—— 实体定义 + 仓储接口及实现(user.go,user_repo.go) -
view/—— 模板文件(user/show.html)或 JSON 渲染辅助函数 -
router/—— 路由配置(用net/http或gorilla/mux)
不复杂但容易忽略的是:MVC 在 Go 中不是靠工具生成的代码,而是靠开发者每天写代码时问自己一句——“这个逻辑放在这里,是否还能被 CLI 命令或 gRPC 接口复用?” 如果答案是肯定的,那它大概率属于 Model;如果只能用于 Web 响应,才考虑放在 Controller 或 View。










