推荐使用 go get github.com/gofiber/fiber/v2，因v3仍处测试阶段、文档不全、生态未对齐、强制要求Go 1.24+，且v2/v3混用会导致构建失败或panic；生产环境应避免使用v3。
直接用 go get github.com/gofiber/fiber/v2，这是当前（2026年10月）唯一推荐的稳定版安装方式。
为什么不是 v3？
v3 仍处于测试阶段，文档不全、生态工具未对齐，且强制要求 Go 1.24+。生产环境混用 v2/v3 import 路径会导致构建失败或运行时 panic。除非你明确在做 v3 兼容性验证，否则别碰 go get github.com/gofiber/fiber/v3。
安装前必须检查 Go 版本
运行 go version 确认版本 ≥ 1.21。若低于该值：
• 不要跳过升级——go get 可能静默拉取旧版兼容分支，导致后续行为异常
• 推荐用 go install golang.org/dl/go1.21@latest 下载并执行 go1.21 download
初始化项目别用 fiber.Default()
它默认加载 Logger、Recover、RequestID 等中间件，I/O 开销大，TTFB 增加 0.3–0.8ms。
• 正确写法是 app := fiber.New()
• 中间件按需添加：debug 环境才加 logger.New()，生产环境 recover 配置里关掉堆栈：recover.New(recover.Config{EnableStackTrace: false})
第一个路由 404？大概率是 StrictRouting 导致的
Fiber 默认 StrictRouting: true，/users 和 /users/ 是两条不同路由。
• 别全局关掉它——否则 /users/:id 会被 /users 错误匹配
• 推荐加个重定向中间件：if strings.HasSuffix(c.Path(), "/") && c.Path() != "/" { c.Redirect(strings.TrimSuffix(c.Path(), "/"), 301) }
• 或显式注册两个路径：app.Get("/users", h) 和 app.Get("/users/", h)
StrictRouting 和中间件加载顺序是上线前最容易忽略的两个点，它们不会报错，但会悄悄拖慢性能或让前端请求反复 404。
