GolangTODO应用开发教程【深入】

本文深入剖析了如何用最简技术栈（net/http + SQLite + 原生 HTML/fetch）稳健构建一个生产可用的 TODO 应用，直击初学者常见误区：不盲目引入 Gin/Echo 等框架，避免过早复杂化；通过关闭 SQLite WAL 模式解决并发写入的 database is locked 顽疾；采用标准结构体与显式 ORDER BY 保障数据可靠性；前端零构建、纯 fetch 直连，配合统一 CORS 头与显式 OPTIONS 处理破除跨域陷阱；全文聚焦“够用、可控、可演进”的工程原则——不是教你怎么快速写完，而是帮你从第一行代码就避开未来加功能时不得不推倒重来的技术债。

用 net/http 启服务就足够，别一上来搞 Gin/echo

Go 写 TODO 应用，最常踩的坑是过早引入 Web 框架。你只是想存几条待办、查一下、删一条——net/http 加 encoding/json 完全够用，启动快、依赖少、调试直观。

真实场景里，90% 的本地开发或小工具级 TODO 应用根本不需要中间件链、路由分组、上下文注入这些。用框架反而让你绕不开它的生命周期钩子、错误包装逻辑，一报错先怀疑是不是自己没配对 router.Use()。

• HTTP 方法直接对应 CRUD：GET /todos 查列表，POST /todos 新增，DELETE /todos/{id} 删除
• 用 http.ServeMux 就能注册路由，不用 http.HandleFunc 也能写清楚路径和 handler 分离
• 避免用 json.RawMessage 或自定义 UnmarshalJSON——除非你要支持嵌套字段或时间格式混用，否则标准结构体 + json:"text,omitempty" 更稳

sqlite3 做存储比内存 map 更靠谱，但得关掉 WAL 模式

很多人用 map[int]*Todo 开发初期觉得“简单”，结果加个刷新页面就丢数据，或者并发 POST 两条导致 ID 冲突。SQLite 是零配置、单文件、ACID 兼容的真退路。

但默认开启的 WAL（Write-Ahead Logging）模式在 Go 的 database/sql 连接池下容易卡住：多个 goroutine 同时写，sqlite3 报 database is locked，不是代码问题，是模式不匹配。

• 初始化 DB 时加 _journal_mode=DELETE&_synchronous=NORMAL 参数，关 WAL，用传统 rollback journal
• 表结构别省事：id INTEGER PRIMARY KEY AUTOINCREMENT 而不是 id INTEGER PRIMARY KEY，否则 SQLite 不保证自增连续性
• 查询全部用 SELECT * FROM todos ORDER BY id DESC，别依赖 INSERT 顺序——SQLite 不保证返回顺序，除非显式 ORDER BY

前端用纯 HTML + fetch 就行，别碰 Vue/React

TODO 应用的 UI 复杂度在「输入框 + 列表 + 删除按钮」这个量级。这时候上构建工具、打包、热更新，等于给自行车装涡轮增压——噪音大，还容易爆缸。

真实痛点是：改了 Go 代码要重启服务，但前端 HTML 改了不用重编译；用 fetch 直连 /todos，出错时浏览器控制台一眼看到是 404 还是 500，而不是被框架拦截成一个模糊的 Network Error。

• HTML 表单 onsubmit="addTodo(); return false;"，避免页面跳转打断状态
• fetch('/todos', {method: 'POST', body: JSON.stringify({text: input.value})})，注意设 Content-Type: application/json
• 删除用 fetch(`/todos/${id}`, {method: 'DELETE'})，后端响应 204 No Content 最干净，前端不用解析返回体

跨域不是必须解决的问题，但 CORS 头漏写会卡死请求

本地开发时，Go 服务跑 :8080，HTML 文件双击打开走 file:// 协议，或者用 VS Code Live Server 走 :5500——这俩都触发浏览器跨域限制。这时候不是前端该改协议，而是后端加头。

但很多人只写 Access-Control-Allow-Origin: *，结果遇到 DELETE 或带 Content-Type: application/json 的 POST，浏览器先发 OPTIONS 预检，而你的 handler 根本没处理它，直接 404，前端就卡在 pending 状态。

• 所有 handler 前统一加三行：w.Header().Set("Access-Control-Allow-Origin", "*")、w.Header().Set("Access-Control-Allow-Methods", "GET, POST, DELETE")、w.Header().Set("Access-Control-Allow-Headers", "Content-Type")
• 单独写一个 OPTIONS 路由，比如 mux.HandleFunc("/todos", optionsHandler).Methods("OPTIONS")，里面只写 w.WriteHeader(204)
• 别信 “开发环境用 Chrome 插件禁用 CORS”——插件不生效于 fetch，只影响 XHR，而且上线前你肯定忘了关

真正难的不是写完功能，是当某天你想加个「按日期过滤」或「标记完成」时，发现之前没留字段、没设计状态机、没把时间存在数据库里——这时候才明白，最开始那张只有 id 和 text 的表，就是给自己埋的雷。

以上就是《GolangTODO应用开发教程【深入】》的详细内容，更多关于的资料请关注golang学习网公众号！