Golang 开发简易 REST API 服务教程

本文手把手教你用 Go 标准库 net/http 快速搭建一个结构清晰、易于扩展的简易 REST API 服务：从定义 User 模型、编写控制器处理用户列表与单个用户查询逻辑，到通过路由分发请求并启动监听，全程零依赖第三方框架；项目采用类 MVC 目录组织，代码简洁可读，运行后即可通过 localhost:8080/users 实时获取 JSON 数据，同时为后续集成 mux 路由、中间件、数据库等生产级功能预留了平滑升级路径——无论你是 Go 新手入门还是需要快速交付轻量接口，这都是一份即学即用、注重实践细节的实用指南。

用 Golang 开发一个简易的 REST API 服务并不复杂，核心是使用标准库 net/http 搭建 HTTP 服务，结合路由分发请求到对应的控制器处理。下面一步步说明如何组织一个结构清晰、可扩展的简易项目。

初始化项目结构

先创建项目目录，建议采用简单的 MVC 风格划分：

• main.go - 程序入口，启动 HTTP 服务
• routes/ - 路由定义
• controllers/ - 处理请求逻辑
• models/ - 数据结构定义（可选）

示例目录结构：

rest-api/
├── main.go
├── routes/
│   └── router.go
├── controllers/
│   └── user_controller.go
└── models/
    └── user.go

定义数据模型

在 models/user.go 中定义一个简单的用户结构体：

这是一个用于 JSON 序列化的基础模型。

编写控制器逻辑

在 controllers/user_controller.go 中实现几个简单的 REST 接口：

这里实现了获取所有用户和根据 ID 获取单个用户的接口。

设置路由分发

在 routes/router.go 中注册路由：

使用标准库的 http.HandleFunc 注册路径与处理函数的映射。注意路径顺序，更具体的应放在后面避免覆盖。

启动主服务

在 main.go 中导入并启动路由：

运行后访问 http://localhost:8080/users 即可看到用户列表。

小结与优化建议

这个简易 REST API 使用了 Go 标准库，无需引入第三方框架。适合学习或小型项目。后续可改进点包括：

• 使用 gorilla/mux 或 chi 增强路由功能（如路径参数、方法限制）
• 加入中间件处理日志、CORS、认证等
• 连接数据库替代内存变量
• 添加错误统一返回格式

基本上就这些，不复杂但容易忽略细节，比如 Header 设置和 JSON 编码错误处理。

今天关于《Golang 开发简易 REST API 服务教程》的内容介绍就到此结束，如果有什么疑问或者建议，可以在golang学习网公众号下多多回复交流；文中若有不正之处，也希望回复留言以告知！