如何在30分钟内用Go编写REST API：实用指南

面向初学者的在线Python训练器

轻松学习Python，无需理论负担。在浏览器中直接解决带自动检查的实践任务，无需安装任何东西。

开始课程

引言：为什么用Go开发REST API？

Go（Golang）是一种现代编译型语言，内置并发支持且性能卓越。用Go开发的REST API运行速度快、内存占用少，且易于扩展。在30分钟内，您将使用标准库创建一个完整的REST服务，支持GET、POST、PUT和DELETE请求。

在本指南中，我们将编写一个用于管理任务列表（Todo应用）的API。您将学习如何配置路由、处理JSON、添加日志中间件以及正确返回错误。无需第三方框架——仅使用纯Go！

\n\n

1. 项目设置与结构

为项目创建一个新目录并初始化Go模块：

mkdir go-todo-api\ncd go-todo-api\ngo mod init todo-api

项目结构将非常简单：

main.go — 入口点和服务器启动
handlers.go — 请求处理程序
models.go — 数据结构
middleware.go — 中间件

创建包含任务结构的models.go文件：

package main\n\ntype Task struct {\n    ID        int    `json:"id"`\n    Title     string `json:"title"`\n    Completed bool   `json:"completed"`\n}

为简单起见，我们将任务存储在内存中（tasks切片）。在实际项目中，请使用数据库。

\n\n

2. 路由与处理程序

Go使用内置的net/http包。创建包含主要处理程序的handlers.go文件。

2.1. GET /tasks — 获取所有任务

package main\n\nimport (\n    "encoding/json"\n    "net/http"\n    "strconv"\n)\n\nvar tasks = []Task{}\nvar nextID = 1\n\nfunc getTasks(w http.ResponseWriter, r *http.Request) {\n    w.Header().Set("Content-Type", "application/json")\n    json.NewEncoder(w).Encode(tasks)\n}

2.2. POST /tasks — 创建新任务

func createTask(w http.ResponseWriter, r *http.Request) {\n    var newTask Task\n    if err := json.NewDecoder(r.Body).Decode(&newTask); err != nil {\n        http.Error(w, "Invalid JSON", http.StatusBadRequest)\n        return\n    }\n    newTask.ID = nextID\n    nextID++\n    tasks = append(tasks, newTask)\n    w.Header().Set("Content-Type", "application/json")\n    w.WriteHeader(http.StatusCreated)\n    json.NewEncoder(w).Encode(newTask)\n}

2.3. PUT /tasks/{id} — 更新任务

func updateTask(w http.ResponseWriter, r *http.Request) {\n    idStr := r.PathValue("id")\n    id, err := strconv.Atoi(idStr)\n    if err != nil {\n        http.Error(w, "Invalid task ID", http.StatusBadRequest)\n        return\n    }\n    \n    var updatedTask Task\n    if err := json.NewDecoder(r.Body).Decode(&updatedTask); err != nil {\n        http.Error(w, "Invalid JSON", http.StatusBadRequest)\n        return\n    }\n    \n    for i, t := range tasks {\n        if t.ID == id {\n            tasks[i].Title = updatedTask.Title\n            tasks[i].Completed = updatedTask.Completed\n            w.Header().Set("Content-Type", "application/json")\n            json.NewEncoder(w).Encode(tasks[i])\n            return\n        }\n    }\n    http.Error(w, "Task not found", http.StatusNotFound)\n}

2.4. DELETE /tasks/{id} — 删除任务

func deleteTask(w http.ResponseWriter, r *http.Request) {\n    idStr := r.PathValue("id")\n    id, err := strconv.Atoi(idStr)\n    if err != nil {\n        http.Error(w, "Invalid task ID", http.StatusBadRequest)\n        return\n    }\n    \n    for i, t := range tasks {\n        if t.ID == id {\n            tasks = append(tasks[:i], tasks[i+1:]...)\n            w.WriteHeader(http.StatusNoContent)\n            return\n        }\n    }\n    http.Error(w, "Task not found", http.StatusNotFound)\n}

请注意