必须先确认 Go 版本≥1.21（v2）或≥1.24（v3），再执行 go get github.com/gofiber/fiber/v2；导入需带 /v2，初始化用 fiber.New() 而非 fiber.Default()，避免默认中间件性能损耗。
必须先确认 Go 版本，否则 go get 会静默失败或拉取错误版本
检查 Go 版本是否满足 Fiber 要求
Fiber v2 支持 Go 1.21+，v3 要求 Go 1.24+（截至 2026 年 10 月仍为测试阶段）。运行以下命令验证：
go version
若输出低于 go1.21，需升级。例如升级到 1.24：
go install golang.org/dl/go1.24@latestgo1.24 download- 再执行
go version确认生效
跳过这步，go get github.com/gofiber/fiber/v2 可能成功但实际拉取的是旧版兼容分支，后续调用 fiber.New() 等 API 会编译报错。
安装命令：v2 是生产唯一推荐版本
绝大多数项目应使用 v2 —— 文档完整、中间件稳定、CI/CD 兼容性好。执行：
go get github.com/gofiber/fiber/v2
注意：-u 参数非必需，且可能触发意外升级；v3 仅用于尝鲜，命令为：
go get github.com/gofiber/fiber/v3
但必须同步满足两个条件：
- Go 版本 ≥
1.24 - import 路径必须写成
github.com/gofiber/fiber/v3，不能和 v2 混用
混用 import 路径会导致类型不匹配、fiber.Ctx 方法缺失等编译错误。
模块导入与初始化：别用 fiber.Default()
在 main.go 中正确导入并初始化：
import "github.com/gofiber/fiber/v2"
然后用：
app := fiber.New()
而不是：
app := fiber.Default()
原因很直接：
-
fiber.Default()默认启用Logger、Recover、RequestID中间件 - 开发时方便，但上线后每请求都记全量日志（含
Authorization头），I/O 压垮 QPS - TTFB 实测增加 0.3–0.8ms，在高并发场景下不可忽略
初始化后加中间件，应按需显式添加，例如只在 debug 环境启用日志：
if os.Getenv("ENV") == "debug" {<br> app.Use(logger.New())<br>}
常见导入错误与路径问题
错误现象包括：undefined: fiber.New、cannot use c (type *fiber.Ctx) as type ...。多数由以下原因导致：
- go.mod 中
require行写成github.com/gofiber/fiber v2.50.0（缺/v2后缀）→ 正确应为github.com/gofiber/fiber/v2 v2.50.0 - 代码中 import 写成
"github.com/gofiber/fiber"（漏版本）→ 必须带/v2 - 同一项目中同时 import
v2和v3→ Go 模块系统无法解析冲突的包路径
运行 go mod tidy 后检查 go.mod 文件，确保所有 fiber 相关行版本路径严格一致。
