小蓝书 Go
开发与源码

从空目录编写核心链路:八个可以验收的小阶段

前置:完成初学十章。此章是练习路线,建议在单独的 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的完整例子讲给没写过代码的人听。能独立复现失败边界,比能复制大段源码更有价值。

— 本篇阅读完毕 —
来源:小蓝书 Go / docs / 03-development/from-zero.md 下载原文
输入关键词,在三个知识库中搜索
支持正文检索 · 直接定位章节Esc 关闭