最简Web服务只需两步：注册路由（http.HandleFunc）和启动监听（http.ListenAndServe），端口格式为":8080"，该函数会阻塞goroutine；GET/POST参数需手动解析表单；返回JSON须设置Content-Type头并确保结构体字段首字母大写。
用 net/http 启动最简 Web 服务
Go 原生 net/http 包足够跑起一个可工作的 Web 服务，不需要任何第三方依赖。核心就两步：注册路由处理函数、调用 http.ListenAndServe。
常见错误是直接写 http.HandleFunc("/", handler) 却忘了启动监听，或者端口被占用时没处理错误返回。
-
http.HandleFunc只注册路由，不启动服务；必须显式调用http.ListenAndServe - 端口如
":8080"开头的冒号不能省略，否则会 panic -
http.ListenAndServe第二个参数传nil表示使用默认的http.DefaultServeMux - 该函数会阻塞当前 goroutine，后续代码不会执行，需另起 goroutine 或放在最后
package main
import (
"fmt"
"net/http"
)
func main() {
http.HandleFunc("/", func(w http.ResponseWriter, r *http.Request) {
fmt.Fprintf(w, "Hello, World!")
})
fmt.Println("Server starting on :8080")
if err := http.ListenAndServe(":8080", nil); err != nil {
fmt.Printf("ListenAndServe error: %v\n", err)
}
}
处理 GET/POST 请求与读取参数
Go 不像某些框架自动解析表单或 query，需要手动调用 r.ParseForm() 或 r.ParseMultipartForm() 才能访问 r.FormValue。漏掉这步会导致始终读不到参数值。
GET 和 POST 的 query 参数都能通过 r.URL.Query().Get("key") 直接读，但表单数据（application/x-www-form-urlencoded）必须先解析。
立即学习“go语言免费学习笔记（深入）”；
-
r.URL.Query().Get("id")安全读 URL 查询参数，无需提前解析 -
r.FormValue("name")读 POST 表单或 query 中同名字段，但要求已调用ParseForm - 上传文件需用
r.MultipartForm，且必须先调用ParseMultipartForm并设置内存限制 - 未调用
ParseForm就读r.FormValue，返回空字符串，无报错，极难排查
func handler(w http.ResponseWriter, r *http.Request) {
if r.Method == "GET" {
id := r.URL.Query().Get("id")
fmt.Fprintf(w, "GET id=%s", id)
return
}
if r.Method == "POST" {
if err := r.ParseForm(); err != nil {
http.Error(w, "ParseForm error", http.StatusBadRequest)
return
}
name := r.FormValue("name")
fmt.Fprintf(w, "POST name=%s", name)
}
}
返回 JSON 而不是纯文本
用 json.Marshal 序列化结构体后，必须手动设置 Content-Type: application/json 头，否则浏览器或客户端可能当作 HTML 或文本解析，导致解析失败。
另外，json.Marshal 遇到不可序列化的字段（如函数、未导出字段）会静默忽略，不报错；若返回空对象 {}，优先检查字段是否首字母小写。
- 务必调用
w.Header().Set("Content-Type", "application/json") - 结构体字段名首字母必须大写，否则
json.Marshal不会输出该字段 - 建议用
json.NewEncoder(w).Encode(data)替代json.Marshal + Write，避免中间字节切片分配 - HTTP 状态码需手动设，例如
w.WriteHeader(http.StatusOK)
type Response struct {
Message string `json:"message"`
Code int `json:"code"`
}
func jsonHandler(w http.ResponseWriter, r *http.Request) {
w.Header().Set("Content-Type", "application/json")
w.WriteHeader(http.StatusOK)
json.NewEncoder(w).Encode(Response{
Message: "OK",
Code: 200,
})
}
为什么不用框架也能走很远
原生 net/http 在简单服务、内部工具、API 网关前置逻辑、健康检查等场景下足够稳定高效。加一层框架（如 Gin、Echo）主要解决的是路由组织、中间件链、错误统一处理、绑定校验等开发体验问题，而非性能瓶颈。
容易被忽略的是：Go 的 http.ServeMux 不支持通配符路由（如 /users/:id）和正则匹配，所有路径匹配逻辑得自己写；同时，没有内置的请求上下文传递机制，跨中间件传值要靠 r.Context() + context.WithValue，但滥用会导致 context 泄露。
- 高并发下
net/http性能损耗极小，瓶颈通常在业务逻辑或 I/O，不在路由分发 - 自定义
http.Handler实现比引入框架更轻量，适合嵌入已有程序 - 调试时直接看标准库源码（
src/net/http/server.go）比查框架文档更快 - 生产环境若需 JWT 验证、CORS、日志、超时控制，建议封装成独立
http.Handler，而非立刻换框架
