应优先使用 fiber v2 而非 v3；v3 仅适用于 go ≥1.24 且需实验特性场景，v2 才是生产环境稳定选择，安装后须用 go list -m 和跳转源码双重验证版本准确性。
别直接跑 go get github.com/gofiber/fiber/v3 —— 大概率装错或静默失败，除非你已确认 Go 版本 ≥ 1.24 且项目明确需要 v3 的实验性特性。
检查 Go 版本是第一道门槛
运行 go version，输出必须是 go version go1.24 或更高。v3 不兼容 1.23 及以下版本，且不会报错提示，只会拉取旧版或失败。若版本不足：
- 用
go install golang.org/dl/go1.24@latest下载新版安装器 - 再执行
go1.24 download安装 - 最后验证
go version是否更新成功
v2 还是 v3？生产环境几乎总该选 v2
v3 截至 2026 年 10 月仍属测试阶段：文档不全、CI/CD 工具链适配滞后、fiber.NewWithCustomCtx 等新 API 在灰度发布中易因版本漂移引发 panic。绝大多数上线服务应坚持：
- 运行
go get github.com/gofiber/fiber/v2 - import 路径写死为
"github.com/gofiber/fiber/v2" - 绝不混用 v2 和 v3 的 import 路径（哪怕只差一个斜杠）
安装后立即验证是否真生效
别只看 go.mod 里有没有那行——常见坑是本地缓存或 proxy 导致实际拉的仍是旧 commit。执行：
-
go list -m github.com/gofiber/fiber/v2，确认输出含v2.57.0或更高（v2 当前稳定版） - 在代码里写
app := fiber.New()后 Ctrl+Click 跳转，确保能进到v2/目录下的源码，而非v3/或顶层 - 如果跳转进了
github.com/gofiber/fiber（无/v2），说明模块路径没对齐，删掉go.sum和vendor重试
真正麻烦的不是装不上，而是装上了却用着旧行为——比如 StrictRouting 默认值或中间件加载逻辑和文档描述不一致，根源常在版本错位。每次 go get 后，花 10 秒验证 go list -m 输出，比上线后查 2 小时 404 更省事。
