Golang 如何开发一个简易 REST API 服务_Golang HTTP 路由与控制器项目_技术教程

使用 net/http 实现 REST API，通过路由分发请求至控制器处理。1. 定义 User 模型用于 JSON 序列化；2. 在 controllers 中实现 GetUsers 和 GetUserByID 处理函数，返回内存用户数据；3. routes/router.go 注册路径路由；4. main.go 启动服务并监听 8080 端口。访问 /users 可获取用户列表。后续可引入 mux 路由、中间件、数据库等增强功能。

用 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 中定义一个简单的用户结构体：

type User struct {
  ID   int    `json:"id"`
  Name string `json:"name"`
  Email string `json:"email"`
}

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

编写控制器逻辑

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

package controllers

import ( "encoding/json" "net/http" )

var users = []models.User{ {ID: 1, Name: "Alice", Email: "alice@example.com"}, {ID: 2, Name: "Bob", Email: "bob@example.com"}, }

func GetUsers(w http.ResponseWriter, r *http.Request) { w.Header().Set("Content-Type", "application/json") json.NewEncoder(w).Encode(users) }

func GetUserByID(w http.ResponseWriter, r *http.Request) { id := r.URL.Path[len("/users/"):]

for _, u := range users { if strconv.Itoa(u.ID) == id { w.Header().Set("Content-Type", "application/json") json.NewEncoder(w).Encode(u) return } } http.Error(w, "User not found", http.StatusNotFound) }

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