用 net/http 的 http.ServeMux 搭建轻量路由骨架，手动解析路径、用 html/template 渲染、database/sql + sqlite3 直连、json.Marshal 统一 API 输出，go run 直接启动。
用 net/http 搭个能跑的路由骨架，别急着上框架
刚写 Go Web 服务，最容易掉进「先选框架」的坑里。其实 net/http 自带的 http.ServeMux 足够撑起博客后端的初期路由——它轻、没隐藏逻辑、出错时堆栈干净。gin 或 echo 的中间件链、反射路由在调试时反而会模糊真实调用路径。
实操建议：
- 用
http.HandleFunc注册/posts、/posts/{id}这类明确路径，先不用通配符或正则；{id}实际得靠strings.Split(r.URL.Path, "/")手动解析，别指望自动绑定 - 所有 handler 函数签名必须是
func(http.ResponseWriter, *http.Request)，返回值不能加 error —— 错误要自己写入ResponseWriter并设状态码（比如w.WriteHeader(http.StatusNotFound)） - 别在 handler 里直接拼 HTML 字符串返回，先用
html/template加载.html文件，哪怕模板只有一行{{.Title}}
用 database/sql + sqlite3 存文章，绕过 ORM 复杂度
博客数据结构简单（标题、内容、发布时间），强行上 GORM 或 ent 会把 3 行 SQL 变成 15 行配置+结构体标签+迁移命令。而 database/sql 配合 github.com/mattn/go-sqlite3 驱动，写起来更接近你脑子里想的 SQL。
常见错误现象：执行 INSERT 后查不到数据，或者 SELECT 返回空结构体。
立即学习“go语言免费学习笔记（深入）”；
原因和对策：
-
db.QueryRow("SELECT ...").Scan(&v)时，变量v类型必须和 SELECT 字段类型严格匹配（比如 SQLite 的 INTEGER 对应 Go 的int64，不是int） - 插入时间字段别用
time.Now().String()，改用time.Now().Format("2006-01-02 15:04:05")，SQLite 才认这个格式 - 事务不是默认开启的，
db.Exec("INSERT ...")是自动提交的；如果要做「插入文章+插入标签」原子操作，得显式调用tx, _ := db.Begin()，再tx.Exec，最后tx.Commit()
用 json.Marshal 直接输出 API，别碰 encoding/xml 或自定义序列化
博客后端初期只要支持两种输出：浏览器访问返回 HTML 页面，curl -H "Accept: application/json" 访问返回 JSON。这时别写两套渲染逻辑，用一个结构体 + json.Marshal 覆盖全部。
使用场景：前端用 Fetch 请求 /api/posts，后端就该返回标准 JSON 数组，而不是 HTML 片段或带 <pre class="brush:php;toolbar:false;"></pre> 包裹的字符串。
参数差异和坑点：
- 结构体字段名首字母必须大写才能被
json.Marshal导出，小写字段永远是空值 - 时间字段默认序列化成长数字（Unix 时间戳），加
json:"created_at,string"tag 才变成可读字符串 - 空字符串、零值字段会出现在 JSON 里，加
json:",omitempty"可跳过，但注意：指针字段为nil时才跳过，""不算 omitempty
用 go run main.go 启动，别急着写 Dockerfile 或 systemd 服务
本地开发阶段，最大的干扰来自「部署层抽象」。写好 main.go 后直接 go run main.go，配合 kill -HUP $(pidof ./blog) 热重启，比折腾 air 或 fresh 工具更可控。
性能与兼容性影响：
- Go 默认 HTTP 服务器并发模型是每个请求一个 goroutine，对博客这种 QPS http.Server.ReadTimeout 等参数
- SQLite 数据库文件路径写成相对路径（如
./data/blog.db），确保go run执行时工作目录正确，否则打开失败报no such file or directory - 如果要用 HTTPS 本地测试，别生成证书，改用
http.ListenAndServeTLS(":8080", "cert.pem", "key.pem", nil)占位，等上线再补真实证书
真正卡住进度的，往往不是语法或框架不会用，而是花半天调通 SQLite 的 busy timeout 或搞不清 template.ParseFiles 的路径查找规则。先让 GET /posts 返回三篇文章的 JSON，再一点点加功能，比一上来就设计「用户权限模块」实在得多。
