前置:完成初学十章。此章是练习路线,建议在单独的 D:\xiaolanshu-practice 编写,不覆盖已经可运行的交付工程。每阶段只在上一步通过后继续。完整源码可作对照,先独立尝试,再看实现。
阶段一:最小 HTTP 服务#
创建目录,运行 go mod init xiaolanshu-practice。写 main.go:
package main import ( "encoding/json" "log" "net/http" ) func main() { mux := http.NewServeMux() mux.HandleFunc("GET /health", func(w http.ResponseWriter, r *http.Request) { w.Header().Set("Content-Type", "application/json") json.NewEncoder(w).Encode(map[string]string{"status": "ok"}) }) log.Fatal(http.ListenAndServe("127.0.0.1:8099", mux)) } |
运行 go run .,浏览器访问8099/health,看到JSON。先解释 Handler 的 w/r 再继续:r是进来的请求,w是回出去的响应。此代码只适合第一步练习,后续要补超时和优雅关闭。
阶段二:输入、输出和错误#
增加 POST /notes,定义 NoteInput,json.NewDecoder 读取请求体;标题去空格后为空返回400;成功返回 {success:true,data:{id:1,title:...}}。先不接数据库,明说数据只在本次请求里,重启不会保留。写 httptest 发送空标题,断言400。
验收:错误请求不能返回200;JSON格式错不会panic;返回Content-Type正确。
阶段三:接 SQLite#
使用与交付版相同的 modernc.org/sqlite 固定版本,database/sql.Open 建连接,创建 notes 表,INSERT 后 LastInsertId,GET按ID查询。把保存与读取放入独立 service,不把所有SQL写进main。Windows路径参考 database.Open 的 file URI 处理。
验收:发一篇、停程序、重启仍能读取。给文件夹改名时数据路径也要检查。测试用 t.TempDir 创建独立库,不能对默认实际库执行清空。
阶段四:登录身份#
先做开发随机验证码,再创建用户和 sessions。按 auth.go 学校验摘要、过期、尝试和消费;签 JWT 但不把敏感数据放payload。给POST /notes加 Actor,拒绝未登录,并把 creator_id 来自可信身份。
验收:同码二次使用失败;篡改JWT失败;退出后旧JWT失败;伪造body.userId不改变作者。不要跳过这一步先做管理员界面。
阶段五:实现幂等点赞#
创建 note_likes(user_id,note_id)组合主键;先做like/unlike目标状态,再做详情COUNT。用24个goroutine同时请求同一关系,最终只有1行。不要先做缓存计数,因为你需要先有可核验的事实表。
验收:重复like成功但不多计数;重复unlike不负数;陌生笔记404;私密笔记非作者不能新增赞。
阶段六:评论与关注#
评论从一级开始,再加 parent_id/reply_id;写跨笔记回复必须失败的测试。关注从有向关系开始,再做 following/fans 两个方向查询。把分页纳入最初契约,不等全部写完才补。
验收:删除根评论后回复不再显示/点赞;用户不能自关注;普通人不能编辑他人笔记。把此阶段每个规则写成一条测试名。
阶段七:接前端#
用 Vite 创建 React+TS工程,先只有一个输入框和发布按钮,fetch 你写的 POST /notes。把代理设置成8099;浏览器Network确认真实请求。再提取 api.ts,统一 token、错误和超时,最后分出列表、详情和编辑组件。
验收:不能靠Date.now模拟数据库ID;发完新建记录马上能读详情;后端关闭时页面清楚报错。等行为稳定,再按设计令牌增加摄影、布局、响应式和减少动画支持。
阶段八:运维与复盘#
添加配置检查、构建脚本、关机、上传白名单、数据库备份和检查文档。运行全套测试、静态检查和依赖审计;保存实际结果,不填不存在的性能成绩。
最后对照本工程:哪些规则你遗漏了?哪些抽象让你更难解释?把一个从HTTP到SQL的完整例子讲给没写过代码的人听。能独立复现失败边界,比能复制大段源码更有价值。