如何在 Go 中利用 map 实现简单的路由算法

直接调用 m["/unknown"]() 会引发 panic，因为没先检查 key 是否存在。Go 里函数类型的零值是 nil，调用 nil 函数必然崩溃。正确的做法是始终用双赋值 handler, ok := m[path] 判断存在性，确认 ok 为 true 后再调用。

为什么直接用 map[string]func() 做路由会 panic

根源不在 map 本身，而在于调用前缺少存在性检查。访问不存在的 key 时，map 返回零值——对于函数类型就是 nil。然后你直接拿这个 nil 当函数调用，运行时当然会爆 panic: call of nil function。很多新手在这里翻车，以为是 map 的锅，其实是对零值语义不熟悉。

实操建议：

• 永远先用双赋值语法判断 key 是否存在：handler, ok := m[path]
• 只在 ok == true 时调用 handler()
• 不要依赖 if m[path] != nil——函数类型的零值就是 nil，但 map 查不到 key 也会返回零值，无法区分“key 不存在”和“key 存在但值为 nil”

支持带参数的路由：用 map[string]func(http.ResponseWriter, *http.Request) 更实用

单纯用 map[string]func() 只能跑通最基础的 demo，真实 HTTP 路由必须拿到请求上下文（比如 URL、Header、Body）。标准库 http.ServeMux 内部也基于类似思路（只是用了更复杂的前缀匹配），你用 map 模拟时，最好直接对齐它的 handler 签名。

示例片段：

routes := map[string]func(http.ResponseWriter, *http.Request){
    "/ping": func(w http.ResponseWriter, r *http.Request) {
        w.WriteHeader(200)
        w.Write([]byte("pong"))
    },
    "/health": func(w http.ResponseWriter, r *http.Request) {
        w.Header().Set("Content-Type", "application/json")
        json.NewEncoder(w).Encode(map[string]bool{"ok": true})
    },
}

// 使用时：
if handler, ok := routes[r.URL.Path]; ok {
    handler(w, r)
    return
}
http.NotFound(w, r)

注意：r.URL.Path 是标准化路径（已解码、已去重斜杠），但不处理查询参数——这正好符合路由的职责，参数解析留给 handler 自己做。

想支持 /user/:id 这类动态路径？map 本身做不到，得加一层匹配逻辑

map 只做精确键匹配，无法原生支持通配或参数提取。硬要用 map 实现简单版动态路由，常见的折中方案是：预定义一组正则或前缀规则，再用 map 存储 handler 和对应的匹配器。

实操建议：

• 避免在每次请求时编译正则——提前用 regexp.MustCompile 初始化好
• 按匹配优先级排序规则（比如先试精确 match，再试前缀，最后试正则），否则 /user 可能被 /user/.* 错误捕获
• 一个轻量示例结构：type Route struct { Pattern *regexp.Regexp; Handler func(http.ResponseWriter, *http.Request, map[string]string) }，然后用 slice 而非 map 存储，遍历时匹配并提取命名组

别试图把所有路由逻辑塞进一个 map——它不是为模式匹配设计的。

性能与并发安全：map 在路由场景下需要额外加锁吗

如果路由表在程序启动后就固定不变（绝大多数情况如此），不需要锁。但 Go 的 map 并发读写会 panic，所以必须确保：初始化完成后不再写入。

关键点：

• 在 init() 或 main() 开头一次性构建好 map，之后只读
• 如果真需要运行时增删路由（比如插件热加载），改用 sync.RWMutex 包裹 map，读操作用 RLock()，写操作用 Lock()
• 别用 sync.Map——它针对高频更新场景优化，而路由表是典型的“一次写、百万读”，sync.Map 的读开销反而更高

真正容易被忽略的是：很多人在 handler 里意外修改了全局路由 map（比如测试时随手 delete(routes, "/test")），结果整个服务随机 panic——这种 bug 很难复现，务必隔离写操作。