Golang入门HTTP请求处理实战案例
答案:从创建简易待办事项API入手,使用Go语言实现获取所有事项、添加新事项及标记完成状态功能,通过定义Todo结构体与内存切片模拟数据存储,结合net/http包处理路由与JSON响应,适合初学者快速掌握GolangHTTP服务基础。
答案:从创建简易待办事项API入手,使用Go语言实现获取所有事项、添加新事项及标记完成状态功能,通过定义Todo结构体与内存切片模拟数据存储,结合net/http包处理路由与JSON响应,适合初学者快速掌握Golang HTTP服务基础。

想快速上手 Golang 的 HTTP 请求处理?从一个简单的 API 服务开始最合适。下面是一个基础但完整的 Golang HTTP 项目案例,适合初学者理解路由、请求处理、JSON 响应和简单业务逻辑。
项目目标
搭建一个简易的“待办事项”(Todo)API,支持以下功能:
- 获取所有待办事项
- 添加新的待办事项
- 根据 ID 标记为完成
项目结构
项目目录结构简洁:
todo-api/├── main.go
└── go.mod
初始化项目
创建项目目录并初始化模块:
mkdir todo-apicd todo-api
go mod init todo-api
定义数据结构
在 main.go 中定义 Todo 结构体和内存存储(用切片模拟数据库):
package main import ( "encoding/json" "log" "net/http" "strconv" ) type Todo struct { ID int `json:"id"` Title string `json:"title"` Done bool `json:"done"` } var todos = []Todo{ {ID: 1, Title: "学习 Go 基础", Done: false}, {ID: 2, Title: "写一个 HTTP 服务", Done: true}, }实现 HTTP 处理函数
编写三个处理函数:
获取所有待办事项
func getTodos(w http.ResponseWriter, r *http.Request) { w.Header().Set("Content-Type", "application/json") json.NewEncoder(w).Encode(todos) }添加新的待办事项
func createTodo(w http.ResponseWriter, r *http.Request) { if r.Method != "POST" { http.Error(w, "只支持 POST 方法", http.StatusMethodNotAllowed) return } var newTodo Todo if err := json.NewDecoder(r.Body).Decode(&newTodo); err != nil { http.Error(w, "请求体格式错误", http.StatusBadRequest) return } newTodo.ID = len(todos) + 1 todos = append(todos, newTodo) w.Header().Set("Content-Type", "application/json") w.WriteHeader(http.StatusCreated) json.NewEncoder(w).Encode(newTodo) }标记为完成
func completeTodo(w http.ResponseWriter, r *http.Request) { idStr := r.URL.Query().Get("id") id, err := strconv.Atoi(idStr) if err != nil || id <= 0 { http.Error(w, "无效的 ID", http.StatusBadRequest) return } for i := range todos { if todos[i].ID == id { todos[i].Done = true w.WriteHeader(http.StatusOK) return } } http.Error(w, "未找到该 ID 的任务", http.StatusNotFound) }注册路由并启动服务
在 main 函数中设置路由和启动服务器:
func main() { http.HandleFunc("/todos", func(w http.ResponseWriter, r *http.Request) { if r.Method == "GET" { getTodos(w, r) } else if r.Method == "POST" { createTodo(w, r) } else { http.Error(w, "不支持的方法", http.StatusMethodNotAllowed) } }) http.HandleFunc("/complete", completeTodo) log.Println("服务器启动在 http://localhost:8080") log.Fatal(http.ListenAndServe(":8080", nil)) }测试 API
启动服务:
go run main.go使用 curl 测试:
- 获取所有任务:
curl http://localhost:8080/todos - 添加新任务:
curl -X POST -H "Content-Type: application/json" -d '{"title":"测试添加"}' http://localhost:8080/todos - 标记完成:
curl -X GET http://localhost:8080/complete?id=1
小结
这个项目涵盖了 Golang HTTP 开发的核心知识点:使用 net/http 包处理请求、解析 JSON、设置响应头、简单的路由分发和错误处理。虽然没有用到第三方框架,但足以帮助理解底层机制。后续可扩展数据库、中间件、验证等功能。
基本上就这些,不复杂但容易忽略细节,比如 Content-Type 和状态码的设置。动手改改,加个删除功能试试?
Photoshop 2026 是 Adobe 推出的专业图像处理与视觉设计软件,支持 Windows、macOS 和 iPad 等平台,广泛应用于摄影修图、电商设计、平面海报、数字绘画及视觉合成等创作场景。
Blender 是一款免费开源、跨平台的专业 3D 创作软件,集建模、动画、渲染、视频编辑与视觉合成等功能于一体,广泛应用于影视动画、游戏设计和建筑可视化等领域。软件支持 Cycles 物理渲染器与 Eevee 实时渲染引擎,并提供多边形建模、骨骼绑定、物理模拟等专业工具。Blender 兼容 Windows、macOS 和 Linux 系统,安装包轻巧、运行流畅,依托活跃的全球开发者社区持续更新,是从初学者到专业创作者都值得选择的正版 3D 创作工具。
Photoshop 2026 是 Adobe 推出的专业图像处理与视觉设计软件,支持 Windows、macOS 和 iPad 等平台,广泛应用于摄影修图、电商设计、平面海报、数字绘画及视觉合成等创作场景。
Blender 是一款免费开源、跨平台的专业 3D 创作软件,集建模、动画、渲染、视频编辑与视觉合成等功能于一体,广泛应用于影视动画、游戏设计和建筑可视化等领域。软件支持 Cycles 物理渲染器与 Eevee 实时渲染引擎,并提供多边形建模、骨骼绑定、物理模拟等专业工具。Blender 兼容 Windows、macOS 和 Linux 系统,安装包轻巧、运行流畅,依托活跃的全球开发者社区持续更新,是从初学者到专业创作者都值得选择的正版 3D 创作工具。















