首页 > Golang > Go教程

Golang 开发简易 REST API 服务教程

时间：2026-04-28 16:49:29 367浏览收藏

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

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

用 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 获取单个用户的接口。