用net/http启动最简Web服务需注册路由再调用ListenAndServe，否则404；GET参数用Query().Get()安全获取；返回JSON须手动设Content-Type头；ServeMux路径匹配为前缀式，注意末尾斜杠。
用 net/http 启动最简 Web 服务
Go 自带的 net/http 包足够跑起一个生产可用的基础服务，不需要额外框架。核心就两步：注册路由 handler，调用 http.ListenAndServe。
常见错误是直接写 http.ListenAndServe(":8080", nil) 却没注册任何路由，结果所有请求都返回 404 —— 因为 nil 表示使用默认的 http.DefaultServeMux，但它初始为空。
- 用
http.HandleFunc注册路径和函数，比如http.HandleFunc("/health", healthHandler) -
端口被占用时会报错
listen tcp :8080: bind: address already in use，可改用随机空闲端口：http.ListenAndServe("localhost:0", nil)，然后从srv.Addr取实际绑定地址 - 开发时建议加超时控制，避免连接堆积：
srv := &http.Server{ Addr: ":8080", Handler: nil, ReadTimeout: 10 * time.Second, WriteTimeout: 10 * time.Second, }
处理 GET 请求并解析 URL 参数
http.Request 的 URL.Query() 返回 url.Values，本质是 map[string][]string，不是普通 map。直接取值要用 .Get()（返回第一个值）或 .All()（返回全部）。
容易踩的坑：用 r.URL.Query()["name"] 拿到的是切片，如果参数没传，会 panic；而 r.URL.Query().Get("name") 安全返回空字符串。
立即学习“go语言免费学习笔记（深入）”；
- GET 参数在
r.URL.Query()，POST 表单数据也在同一位置（只要 Content-Type 是application/x-www-form-urlencoded） - 想统一读所有参数，可先调
r.ParseForm()，再用r.FormValue("key")—— 它自动合并 URL 查询和表单体中的同名字段 - 中文参数需确保前端用 UTF-8 编码，Go 默认按 UTF-8 解码，无需额外处理
返回 JSON 响应并设置正确 Header
Go 没有内置 JSON 响应快捷方法，必须手动设 Content-Type，否则浏览器或客户端可能当文本处理，导致解析失败。
典型错误是只写 json.NewEncoder(w).Encode(data)，却忘了 w.Header().Set("Content-Type", "application/json; charset=utf-8")。
- 务必在调用
Encode()前设置 Header，之后设置无效 - 如果结构体字段首字母小写（未导出），
json.Marshal会忽略它，返回空对象{} - 时间字段建议用
time.Time+json:"time,omitempty"标签，并提前调time.Local或UTC()统一时区
用 http.ServeMux 实现简单路由分发
默认的 http.DefaultServeMux 足够用于小项目，但不支持路径参数（如 /user/:id）或通配符。真要动态路径，得自己实现匹配逻辑或引入第三方 mux（如 gorilla/mux），但多数内部服务用前缀匹配就够了。
注意 ServeMux 的路径匹配是前缀式，http.HandleFunc("/api", ...) 会同时匹配 /api、/api/users、甚至 /apixxx —— 所以末尾加斜杠更安全：/api/。
- 注册
/api/后，可通过r.URL.Path截取子路径：strings.TrimPrefix(r.URL.Path, "/api/") - 多个
HandleFunc注册相同路径，后注册的会覆盖前面的，无警告 - 如果需要 404 控制权，别用
nilhandler，而是显式传入自定义*http.ServeMux，并在最后加兜底路由：mux.HandleFunc("/", notFoundHandler)
没有中间件、没有 ORM、没有模板引擎——这些都不是必须的起点。真正卡住人的，往往是忘记设 Content-Type、误判 Query() 返回类型，或者把 ListenAndServe 放在 goroutine 里却没做错误处理。
