Golang快速开发REST API教程

使用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。

示例代码：

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设计原则。