go version ≥ 1.21 是安装 Fiber v2 的前提，低于该版本会静默拉取不兼容旧分支；应升级 Go 至 1.24，用 go get github.com/gofiber/fiber/v2（不加 -u），初始化仅用 fiber.New()，热重载需借助 air 或 reflex，StrictRouting 导致的 404 应通过显式注册或重定向中间件解决。
go get 安装 Fiber 时版本和 Go 版本必须对齐
直接 go get github.com/gofiber/fiber/v2 就能装上稳定版，但前提是你的 go version ≥ 1.21。如果输出是 go version go1.20.14，那命令会静默拉取一个不兼容的旧分支（比如 v2.49.x 降级到 v2.28），后续编译可能报 undefined: fiber.NewWithCustomCtx 这类符号缺失错误。
检查并升级 Go 的实操步骤：
- 运行
go version确认当前版本 - 若低于 1.21，执行
go install golang.org/dl/go1.24@latest && go1.24 download（v2 兼容 1.21+，但用 1.24 更稳） - 装完后用
go1.24 version验证，再切回系统默认：go env -w GOROOT=$(go1.24 env GOROOT) - 最后跑
go get github.com/gofiber/fiber/v2—— 不要加-u，避免意外升级到 v3 测试版
fiber.New() 是唯一安全的初始化方式，别碰 fiber.Default()
热重载本身不关心你用哪个初始化函数，但 fiber.Default() 会悄悄拖慢整个开发循环：它默认加载 Logger、Recover、RequestID 三个中间件，每次保存文件触发重载后，前几秒的请求日志全打在终端里，干扰调试输出，还可能掩盖真实 panic。
正确写法就一行：
app := fiber.New()
后续按需加中间件，例如开发期只开 recover：
app.Use(recover.New(recover.Config{EnableStackTrace: false}))如果真要日志，用 logger.New(logger.Config{Format: "${status} - ${method} ${path}\n"})，去掉 Authorization 和 Body 字段，避免敏感信息刷屏。
热重载不能靠 go run，得用 air 或 reflex
Fiber 本身不提供热重载能力。go run main.go 每次改完都得手动 Ctrl+C 再敲一遍，效率极低。必须借助外部工具，推荐 air（生态最熟）或 reflex（二进制单文件，无依赖）。
用 air 的最小配置（.air.toml）：
root = "." tmp_dir = "tmp" [build] cmd = "go build -o ./tmp/main ." bin = "./tmp/main" delay = 1000 exclude_dir = ["tmp", "vendor", "examples"] include_ext = ["go", "mod", "sum"] include_file = [] [log] main_only = false
然后终端执行 air 即可。注意两点：
- 别把
go build命令写成go run，后者无法复用tmp目录缓存，重载变慢 - 如果项目有 cgo 依赖（比如 SQLite），加
build_flags = ["-tags=sqlite"]到[build]段
StrictRouting 导致热重载后路由 404？不是 bug，是设计
改完代码保存，air 重启服务，突然发现 /users/ 返回 404，但 /users 没问题——这不是热重载的问题，是 Fiber 默认 StrictRouting: true 在起作用。它把结尾斜杠当作路径语义的一部分，/users 和 /users/ 是两条独立路由。
解决方法只有两个，选一个就行：
- 显式注册两种：
app.Get("/users", h)和app.Get("/users/", h) - 加统一重定向中间件（放最前面）：
app.Use(func(c *fiber.Ctx) error {<br> if strings.HasSuffix(c.Path(), "/") && c.Path() != "/" {<br> return c.Redirect(strings.TrimSuffix(c.Path(), "/"), 301)<br> }<br> return c.Next()<br>})
千万别在 fiber.New() 里设 StrictRouting: false。一旦关掉，像 /users 和 /users/:id 同时存在时，/users/123 可能被前者匹配，c.Params("id") 拿不到值，这种问题在热重载频繁启停时更难定位。
