Go语言实现待办清单CRUD项目实战

本文详细讲解了如何使用 Go 语言标准库（net/http）从零实现一个轻量、健壮且并发安全的待办清单（TODO）CRUD REST API，全程不依赖任何第三方框架或数据库——通过 map+sync.RWMutex 实现高效内存存储与线程安全，ID 自增计数器避免 map 长度陷阱，严格 JSON 编解码校验防止前端异常输入，规范结构体标签与错误处理，并强调 ListenAndServe 的日志与容错机制；这不仅是一次扎实的 Go 实战演练，更揭示了“小而美”服务的核心设计哲学：用最简技术栈构建可扩展骨架，后续轻松插拔持久化、认证、监控等能力——适合初学者建立工程直觉，也值得资深开发者重温底层细节。

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)。注意三点：

• 全局变量声明为 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() 和计数器同步，本地跑得通不代表压测不出问题。

以上就是本文的全部内容了，是否有顺利帮助你解决问题？若是能给你带来学习上的帮助，请大家多多支持golang学习网！更多关于Golang的相关知识，也可关注golang学习网公众号。