答案:使用Golang标准库net/http可快速搭建REST API,定义User结构体和全局切片模拟数据,实现GET请求获取用户列表和单个用户,通过json.NewEncoder设置Content-Type为application/json并返回JSON数据;利用Gorilla Mux增强路由功能,支持路径参数提取和HTTP方法限制,添加POST处理函数createUser解析请求体中的JSON数据,生成新ID并追加到用户列表,返回状态码201及创建的用户信息,完整实现基础RESTful接口。

用Golang搭建一个简单的REST API服务并不复杂,Go语言标准库已经提供了足够的工具来快速实现。下面是一个清晰、实用的实现方式,适合初学者上手。
使用标准库 net/http 创建基础服务
Go 的 net/http 包可以轻松启动HTTP服务并处理路由和请求。以下是一个最简REST服务示例:
package main
import (
"encoding/json"
"log"
"net/http"
)
type User struct {
ID int `json:"id"`
Name string `json:"name"`
}
var users = []User{
{ID: 1, Name: "Alice"},
{ID: 2, Name: "Bob"},
}
func getUsers(w http.ResponseWriter, r *http.Request) {
w.Header().Set("Content-Type", "application/json")
json.NewEncoder(w).Encode(users)
}
func getUser(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)
}
func main() {
http.HandleFunc("/users", getUsers)
http.HandleFunc("/users/", getUser)
log.Println("Server starting on :8080")
log.Fatal(http.ListenAndServe(":8080", nil))
}
说明:
- 定义了一个 User 结构体,并初始化一个全局切片作为“数据存储”
- /users 返回所有用户列表
- /users/{id} 根据路径提取ID返回单个用户
- 设置响应头为 JSON 格式,使用 json.NewEncoder 编码输出
使用 Gorilla Mux 增强路由功能
标准库的路由能力有限,Gorilla Mux 是一个流行的第三方路由器,支持命名参数、方法限制等。
立即学习“go语言免费学习笔记(深入)”;
安装:
go get github.com/gorilla/mux
改写路由部分:
import "github.com/gorilla/mux"
func main() {
r := mux.NewRouter()
r.HandleFunc("/users", getUsers).Methods("GET")
r.HandleFunc("/users/{id}", getUser).Methods("GET")
log.Println("Server starting on :8080")
log.Fatal(http.ListenAndServe(":8080", r))
}
在 getUser 中获取参数:
vars := mux.Vars(r) id := vars["id"]
这种方式更清晰、安全,也更容易扩展POST、PUT、DELETE等操作。
添加 POST 请求处理示例
实现创建用户功能:
func createUser(w http.ResponseWriter, r *http.Request) {
var user User
json.NewDecoder(r.Body).Decode(&user)
user.ID = len(users) + 1
users = append(users, user)
w.Header().Set("Content-Type", "application/json")
w.WriteHeader(http.StatusCreated)
json.NewEncoder(w).Encode(user)
}
注册路由:
r.HandleFunc("/users", createUser).Methods("POST")
这样就可以接收JSON格式的用户数据并添加到列表中。
基本上就这些。用Go写REST API可以从标准库开始,逐步引入Mux等工具提升可维护性。不复杂但容易忽略细节,比如设置Header、正确返回状态码。










