使用Gin框架可快速构建REST API，通过net/http处理HTTP请求，结合GORM操作数据库，合理分层（main、handlers、services、models）提升可维护性，遵循REST原则实现CRUD，配合中间件与统一错误处理，逐步扩展JWT鉴权与Swagger文档功能。
用Golang开发REST API接口并不复杂，关键在于理解HTTP处理机制和合理组织代码结构。Go语言标准库已经提供了足够的支持，配合一些常用第三方包，可以快速构建高效、稳定的API服务。
选择合适的Web框架
虽然Go的标准库net/http足够强大，但使用轻量级框架能提升开发效率。
- 标准库 net/http：适合简单项目，学习成本低，依赖少
- Gin：性能优秀，API简洁，中间件生态丰富，适合大多数REST场景
- Echo：设计优雅，错误处理清晰，文档完善
以Gin为例，安装方式为：go get -u github.com/gin-gonic/gin
定义路由与处理函数
REST API的核心是资源的增删改查（CRUD），对应HTTP方法GET、POST、PUT、DELETE。
立即学习“go语言免费学习笔记（深入）”；
示例代码：
package main
import (
"net/http"
"github.com/gin-gonic/gin"
)
type User struct {
ID uint `json:"id"`
Name string `json:"name"`
}
var users = []User{{ID: 1, Name: "Alice"}}
func main() {
r := gin.Default()
r.GET("/users", func(c *gin.Context) {
c.JSON(http.StatusOK, users)
})
r.POST("/users", func(c *gin.Context) {
var newUser User
if err := c.ShouldBindJSON(&newUser); err != nil {
c.JSON(http.StatusBadRequest, gin.H{"error": err.Error()})
return
}
users = append(users, newUser)
c.JSON(http.StatusCreated, newUser)
})
r.Run(":8080")
}
这段代码实现了获取用户列表和创建新用户的接口。
结构化项目目录
随着功能增多，应将代码分层管理，提高可维护性。
- main.go：程序入口，初始化路由
- handlers/：处理HTTP请求，调用业务逻辑
- services/：核心业务逻辑
- models/：数据结构定义，如数据库模型
- middleware/：自定义中间件，如身份验证
良好的结构让团队协作更顺畅，也便于后期扩展。
集成数据库与错误处理
实际项目通常需要持久化数据。可用GORM操作数据库。
安装GORM：go get -u gorm.io/gorm
在handler中调用service层进行数据库操作，并统一返回JSON格式错误信息。例如：
c.JSON(http.StatusInternalServerError, gin.H{
"error": "failed to fetch data"
})
同时建议使用日志记录关键操作，方便排查问题。
基本上就这些。从简单入手，逐步加入验证、JWT鉴权、Swagger文档等功能，就能构建出完整的REST API服务。关键是保持接口语义清晰，遵循REST设计原则。
