Go 语言用 net/http 实现轻量级 TODO:路由对齐 CRUD,map[int]*Todo+sync.RWMutex 并发安全存储,ID 自增计数器,JSON 编解码严格校验 err,结构体字段导出并加 json tag,ListenAndServe 加错误处理与日志。

Go 语言实现一个轻量级 TODO 待办清单,核心在于用标准库快速搭起 HTTP 服务 + 内存存储(开发调试够用),不引入数据库或框架就能跑通 CRUD 流程。下面直接说关键怎么做。
用 net/http 搭 API 路由,别碰第三方 mux
初学者容易一上来就装 gorilla/mux 或 gin,但标准库完全能应付简单 REST 接口。重点是把方法和路径对齐,避免路由冲突:
-
GET /todos→ 列出全部 -
POST /todos→ 创建一个(读取 JSON body) -
GET /todos/{id}→ 查单个(用strings.TrimPrefix(r.URL.Path, "/todos/")提取 ID) -
PUT /todos/{id}→ 更新(先查是否存在,再覆盖字段) -
DELETE /todos/{id}→ 删除(注意检查 ID 是否合法)
不用正则或复杂参数解析,ID 就当字符串处理,后端转 strconv.Atoi 判断是否为数字即可。
map[int]*Todo 做内存存储,别用 slice 直接遍历查
用切片存 TODO,每次 GET /todos/{id} 都得遍历,O(n) 太慢;改用 map[int]*Todo,ID 当 key,查删都是 O(1)。注意三点:
立即学习“go语言免费学习笔记(深入)”;
- 全局变量声明为
var todos = make(map[int]*Todo),加sync.RWMutex保护并发读写 - ID 自增不能靠
len(todos)+1——map 删除后长度不变,应维护独立计数器nextID int - 新建 TODO 时记得
mu.Lock()→ 分配 ID → 写 map →mu.Unlock(),顺序不能反
JSON 编解码必须检查 err,尤其 json.Unmarshal
常见错误:前端发了空 body、字段类型错(比如 "completed": "true" 字符串)、少字段,json.Unmarshal 会静默失败或部分赋值。务必这样写:
if err := json.NewDecoder(r.Body).Decode(&todo); err != nil {
http.Error(w, "invalid JSON: "+err.Error(), http.StatusBadRequest)
return
}
结构体字段要导出(首字母大写),且加 json: tag,例如:
type Todo struct {
ID int `json:"id"`
Text string `json:"text"`
Completed bool `json:"completed"`
}
别漏掉 `json:"-"` 忽略敏感字段,也别让零值(如空字符串、0)被误当成有效输入。
启动服务前加 http.ListenAndServe 错误处理
很多人写完 http.ListenAndServe(":8080", nil) 就结束,但端口被占、权限不足时进程直接 panic 退出,看不到提示。改成:
log.Println("Server starting on :8080")
if err := http.ListenAndServe(":8080", nil); err != nil {
log.Fatal("ListenAndServe error:", err)
}
另外,开发阶段建议加一行 log.Printf("Handling %s %s", r.Method, r.URL.Path) 在每个 handler 开头,方便定位请求卡在哪。
内存存储没持久化、没用户隔离、没分页、没时间戳——这些不是遗漏,而是刻意留白。真实项目里,替换存储层(换 SQLite / PostgreSQL)和加中间件(JWT、日志)都是在现有骨架上插拔,而不是推倒重来。最易被忽略的其实是并发安全那几行 mu.Lock() 和计数器同步,本地跑得通不代表压测不出问题。










