必须先确认Go版本再选v2或v3：v2要求≥1.21，v3要求≥1.24；生产项目推荐v2，v3截至2026年10月仍为测试阶段，仅限PoC或压测使用。
必须先确认 Go 版本，再决定安装 v2 还是 v3 —— 跳过这步，go get 很可能静默失败或拉来不兼容的旧版。
检查当前 Go 版本是否达标
Fiber v2 支持最低 Go 1.21+，v3 要求 Go 1.24+。运行 go version 查看实际版本。若低于要求：
- 用
go install golang.org/dl/go1.24@latest下载新版本工具链 - 再执行
go1.24 download完成安装 - 验证：运行
go1.24 version确认输出含go1.24
别直接改系统默认 go 命令——CI/CD 流水线里容易因环境不一致出错；建议在项目根目录加 go.work 或用 GOBIN 指向新工具链。
绝大多数生产项目应选 fiber/v2
截至 2026 年 10 月，v3 仍属测试阶段：文档滞后、生态工具（如 Swagger 插件、CLI 工具）未完全适配，fiber.NewWithCustomCtx 等新 API 在多环境部署时易因版本漂移触发 panic。
- 稳定项目：运行
go get github.com/gofiber/fiber/v2 - import 路径必须写全：
github.com/gofiber/fiber/v2，不能漏掉/v2 - 若已有
v1或无版本号导入，go mod tidy会报冲突，需手动清理旧引用
想试 fiber/v3？只在明确场景下才考虑
仅推荐用于本地 PoC、性能压测或参与 v3 生态共建。启用前必须同时满足：
- Go 版本 ≥ 1.24（
go1.24命令可用） - 整个模块中所有
import都统一为github.com/gofiber/fiber/v3 - 禁用
go.sum校验（临时）：加-mod=mod参数避免校验失败 - 注意
v3的Ctx是接口而非指针，原有中间件若做类型断言（如if c2, ok := c.(*fiber.Ctx)）会编译失败
v2 和 v3 的 import 路径不能混用，模块内一旦引入两者，go build 直接报错，且错误信息不提示具体哪行——得逐个检查 go.mod 和所有 import 语句。
