使用Golang开发RESTful API需先初始化项目并引入gorilla/mux路由库，定义User结构体作为数据模型，1. 使用map模拟内存存储并预置用户数据，2. 通过mux.Router注册GET、POST、PUT、DELETE路由，3. 实现获取、创建、更新、删除用户的处理器函数，4. 在main函数中启动HTTP服务，5. 最后用curl测试各接口功能。
构建RESTful API是现代后端开发的常见需求，Golang凭借其高性能、简洁语法和强大标准库，成为实现RESTful服务的理想选择。本文将带你一步步使用Golang开发一个基础但完整的RESTful API，涵盖路由、请求处理、数据序列化与简单持久化。
1. 初始化项目并引入依赖
创建项目目录并初始化模块：
mkdir go-rest-api cd go-rest-api go mod init github.com/yourname/go-rest-api
虽然Go的标准库已足够处理HTTP服务，但为了更灵活的路由控制，推荐使用 gorilla/mux 路由器：
go get github.com/gorilla/mux
2. 定义数据模型
假设我们要实现一个简单的“用户管理”API。先定义User结构体：
type User struct {
ID string `json:"id"`
Name string `json:"name"`
Email string `json:"email"`
}
使用 json 标签确保字段在JSON序列化时正确映射。
3. 模拟数据存储
为简化示例，使用内存map模拟数据库：
var users map[string]Userfunc init() { users = make(map[string]User) // 添加初始数据 users["1"] = User{ID: "1", Name: "Alice", Email: "alice@example.com"} users["2"] = User{ID: "2", Name: "Bob", Email: "bob@example.com"} }
4. 实现RESTful路由与处理器
使用 gorilla/mux 注册不同HTTP方法对应的处理函数：
r := mux.NewRouter()r.HandleFunc("/users", getUsers).Methods("GET")
r.HandleFunc("/users/{id}", getUser).Methods("GET") r.HandleFunc("/users", createUser).Methods("POST") r.HandleFunc("/users/{id}", updateUser).Methods("PUT") r.HandleFunc("/users/{id}", deleteUser).Methods("DELETE")
r.HandleFunc("/users/{id}", getUser).Methods("GET")
r.HandleFunc("/users", createUser).Methods("POST")
r.HandleFunc("/users/{id}", updateUser).Methods("PUT")
r.HandleFunc("/users/{id}", deleteUser).Methods("DELETE")每个处理器函数示例如下：
获取所有用户
func getUsers(w http.ResponseWriter, r *http.Request) {
var result []User
for _, u := range users {
result = append(result, u)
}
w.Header().Set("Content-Type", "application/json")
json.NewEncoder(w).Encode(result)
}
根据ID获取单个用户
func getUser(w http.ResponseWriter, r *http.Request) {
params := mux.Vars(r)
id := params["id"]
if user, ok := users[id]; ok {
w.Header().Set("Content-Type", "application/json")
json.NewEncoder(w).Encode(user)
} else {
http.Error(w, "用户不存在", http.StatusNotFound)
}
}
创建用户
func createUser(w http.ResponseWriter, r *http.Request) {
var user User
if err := json.NewDecoder(r.Body).Decode(&user); err != nil {
http.Error(w, "请求数据格式错误", http.StatusBadRequest)
return
}
users[user.ID] = user
w.Header().Set("Content-Type", "application/json")
w.WriteHeader(http.StatusCreated)
json.NewEncoder(w).Encode(user)
}
更新用户
func updateUser(w http.ResponseWriter, r *http.Request) {
params := mux.Vars(r)
id := params["id"]
if _, ok := users[id]; !ok {
http.Error(w, "用户不存在", http.StatusNotFound)
return
}
var updatedUser User
if err := json.NewDecoder(r.Body).Decode(&updatedUser); err != nil {
http.Error(w, "数据解析失败", http.StatusBadRequest)
return
}
updatedUser.ID = id
users[id] = updatedUser
json.NewEncoder(w).Encode(updatedUser)}
删除用户
func deleteUser(w http.ResponseWriter, r *http.Request) {
params := mux.Vars(r)
id := params["id"]
if _, ok := users[id]; !ok {
http.Error(w, "用户不存在", http.StatusNotFound)
return
}
delete(users, id)
w.WriteHeader(http.StatusNoContent)
}
5. 启动HTTP服务器
在 main 函数中启动服务：
func main() {
r := mux.NewRouter()
// 注册路由...
fmt.Println("服务器启动，端口: 8080")
log.Fatal(http.ListenAndServe(":8080", r))}
运行程序：go run main.go，即可通过 curl 或 Postman 测试接口。
6. 测试API示例
使用 curl 验证功能：
# 获取所有用户
curl -X GET https://www./link/226ad861fc651e3635a98cc062b602f6
创建用户
curl -X POST https://www./link/226ad861fc651e3635a98cc062b602f6 \
-H "Content-Type: application/json" \
-d '{"id":"3","name":"Charlie","email":"charlie@example.com"}'
获取指定用户
curl -X GET https://www./link/226ad861fc651e3635a98cc062b602f6/3
基本上就这些。这个指南展示了用Golang从零实现RESTful API的核心流程：定义模型、设置路由、编写处理器、处理JSON和启动服务。实际项目中可替换内存存储为数据库（如PostgreSQL、MongoDB），并加入中间件处理日志、认证、验证等。Golang的简洁性让API开发既高效又可靠。
