本文详细介绍如何使用原生Golang标准库搭建一个轻量级的RESTful API服务，涵盖项目结构设计、HTTP路由注册、请求处理、数据序列化等核心环节，帮助开发者快速掌握Go语言构建Web服务的基础能力。

在现代后端开发中，REST API已成为服务间通信的标准方式。而Golang凭借其简洁的语法、高效的并发模型和出色的性能表现，逐渐成为构建微服务和API服务的热门选择。更重要的是，Golang的标准库net/http已经足够强大，无需引入第三方框架即可实现一个功能完整的REST API服务。

首先，我们需要初始化一个Go项目。创建项目目录后，在终端执行go mod init your-project-name来生成模块文件。接下来，创建主程序文件main.go，这是整个服务的入口。在该文件中，我们导入必要的包："net/http"用于处理HTTP请求，"encoding/json"用于JSON编解码，"log"用于日志输出。

一个典型的REST API通常包含资源的增删改查（CRUD）操作。假设我们要构建一个管理“用户”资源的服务，可以先定义一个User结构体：

go type User struct { ID int `json:"id"` Name string `json:"name"` Age int `json:"age"` }

结构体字段后的json标签用于控制JSON序列化时的字段名称。接着，我们可以用一个切片模拟数据库存储：

go var users []User

在main函数中，我们通过http.HandleFunc注册不同的路由处理器。例如，处理获取所有用户的GET请求：

go http.HandleFunc("/users", func(w http.ResponseWriter, r *http.Request) { if r.Method == "GET" { w.Header().Set("Content-Type", "application/json") json.NewEncoder(w).Encode(users) } })

这里设置了响应头为JSON格式，并将users切片编码为JSON返回。对于创建用户的操作，我们需要处理POST请求并解析请求体中的JSON数据：

go if r.Method == "POST" { var user User json.NewDecoder(r.Body).Decode(&user) user.ID = len(users) + 1 users = append(users, user) w.WriteHeader(http.StatusCreated) json.NewEncoder(w).Encode(user) }

这段代码读取请求体，反序列化为User对象，分配ID后添加到列表中，并返回201状态码表示资源创建成功。

为了实现更精细的路由控制，比如根据ID获取特定用户，我们可以使用路径参数。虽然标准库不直接支持动态路由，但可以通过字符串前缀匹配和手动解析实现：

go if r.URL.Path == "/users" && r.Method == "GET" { /* 列出所有 */ } if strings.HasPrefix(r.URL.Path, "/users/") && r.Method == "GET" { idStr := strings.TrimPrefix(r.URL.Path, "/users/") // 解析id并查找用户 }

错误处理也是API服务的重要部分。当请求的用户不存在时，应返回404状态码：

go w.WriteHeader(http.StatusNotFound) json.NewEncoder(w).Encode(map[string]string{"error": "用户未找到"})

最后，通过http.ListenAndServe(":8080", nil)启动服务器监听8080端口。整个服务结构清晰，逻辑直观。随着业务复杂度上升，可以进一步封装路由、引入中间件处理日志、认证等功能，或考虑使用Gin、Echo等成熟框架提升开发效率。

通过这种方式，我们仅用几十行代码就构建了一个具备基本功能的REST API，充分体现了Golang在Web服务开发中的简洁与高效。