Go语言中构建RESTful API常用方式包括：使用net/http标准库实现轻量级服务，适合学习和简单项目；采用Gin框架提升开发效率，支持路由、中间件和JSON响应；利用Gorilla Mux实现复杂路由规则；结合结构体与JSON序列化自动化处理请求数据。根据项目需求选择合适方案，注重路由设计、统一返回格式和错误处理。
在Go语言中构建RESTful API是后端开发的常见需求。Golang凭借其简洁的语法、高效的并发支持和标准库的完善，非常适合用来开发高性能的REST服务。以下是几种主流且实用的实现方式汇总，帮助你快速上手并选择合适的方案。
使用 net/http 标准库直接实现
Go的标准库 net/http 提供了完整的HTTP服务支持，无需引入第三方框架即可实现RESTful接口。
适合轻量级项目或学习理解底层机制。
示例：定义一个简单的用户接口：
立即学习“go语言免费学习笔记（深入）”；
package main
import (
"encoding/json"
"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 main() {
http.HandleFunc("/users", getUsers)
http.ListenAndServe(":8080", nil)
}
通过 http.HandleFunc 注册路由，手动设置Header和返回数据。虽然灵活，但随着接口增多，路由管理会变得繁琐。
使用 Gin 框架快速开发
Gin 是目前最流行的Go Web框架之一，以性能高、API简洁著称，非常适合构建RESTful服务。
安装：go get -u github.com/gin-gonic/gin
示例：
package main
import (
"github.com/gin-gonic/gin"
)
func main() {
r := gin.Default()
r.GET("/users", func(c *gin.Context) {
users := []map[string]interface{}{
{"id": 1, "name": "Alice"},
{"id": 2, "name": "Bob"},
}
c.JSON(200, users)
})
r.POST("/users", func(c *gin.Context) {
c.JSON(201, gin.H{"message": "User created"})
})
r.Run(":8080")
}
Gin提供了结构化路由、中间件支持、参数绑定与验证等功能，极大提升开发效率。
使用 Gorilla Mux 实现更灵活的路由
Gorilla Mux 是一个功能强大的HTTP路由器，支持变量路由、正则匹配、方法过滤等，适合需要精细控制路由的场景。
安装：go get github.com/gorilla/mux
示例：
package main
import (
"encoding/json"
"net/http"
"github.com/gorilla/mux"
)
func getUser(w http.ResponseWriter, r *http.Request) {
vars := mux.Vars(r)
id := vars["id"]
user := map[string]string{"id": id, "name": "Alice"}
json.NewEncoder(w).Encode(user)
}
func main() {
r := mux.NewRouter()
r.HandleFunc("/users/{id}", getUser).Methods("GET")
http.ListenAndServe(":8080", r)
}
Mux适合需要复杂路由规则或与其他组件集成的项目。
结合 Struct 和 JSON 自动化处理请求
在实际开发中，通常会定义结构体来映射请求和响应数据，利用Go的JSON序列化能力简化处理。
示例：
type Product struct {
ID int `json:"id"`
Name string `json:"name"`
Price float64 `json:"price"`
}
func createProduct(c *gin.Context) {
var product Product
if err := c.ShouldBindJSON(&product); err != nil {
c.JSON(400, gin.H{"error": err.Error()})
return
}
// 保存逻辑...
c.JSON(201, product)
}
通过结构体标签（struct tag）控制JSON字段名，配合框架的绑定功能，减少手动解析负担。
基本上就这些。根据项目规模和团队习惯，可以选择标准库起步，或直接使用Gin这类高效框架加速开发。关键是设计清晰的路由、统一的返回格式和良好的错误处理机制。不复杂但容易忽略。
