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

想快速上手 Golang 的 HTTP 请求处理?从一个简单的 API 服务开始最合适。下面是一个基础但完整的 Golang HTTP 项目案例,适合初学者理解路由、请求处理、JSON 响应和简单业务逻辑。
项目目标
搭建一个简易的“待办事项”(Todo)API,支持以下功能:
- 获取所有待办事项
- 添加新的待办事项
- 根据 ID 标记为完成
项目结构
项目目录结构简洁:
todo-api/├── main.go
└── go.mod
初始化项目
创建项目目录并初始化模块:
立即学习“go语言免费学习笔记(深入)”;
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 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注册路由并启动服务
在 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 和状态码的设置。动手改改,加个删除功能试试?










