用 net/http 足够开发 todo 应用,无需过早引入 gin/echo;sqlite 关 wal 模式避免 locked 错误;纯 html + fetch 实现 crud,统一加 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 的表,就是给自己埋的雷。
golang免费学习笔记(深入):立即使用
在学习笔记中,你将探索golang的核心概念和高级技巧!











