Fiber 框架需按项目独立管理依赖，多项目复用依靠 Go module 的统一版本声明（如 require github.com/gofiber/fiber/v2 v2.56.0），而非全局安装；v2 是当前稳定版，v3 不兼容且不可混用。
Fiber 框架不能通过全局安装复用，必须按项目独立管理依赖；多项目间复用靠 Go module 机制 + 统一版本约束，而非“一次安装到处用”。
go get 安装命令必须带版本号，且推荐 v2
Fiber 当前稳定生产版本是 v2.x（截至 2026 年 10 月），v3 仍处于测试阶段，不建议用于关键服务。安装时必须显式指定版本，否则可能拉取不稳定快照：
-
go get github.com/gofiber/fiber/v2✅ 推荐：拉取最新 v2 稳定版 -
go get github.com/gofiber/fiber❌ 危险：可能命中未标记的 v3 开发分支 -
go get -u github.com/gofiber/fiber/v2⚠️ 谨慎：强制升级所有间接依赖，易引发兼容问题
安装后，go.mod 中会写入类似 github.com/gofiber/fiber/v2 v2.56.0 的精确版本，这是多项目复用的锚点。
多项目复用 Fiber 的本质是复用 go.mod 版本声明
所谓“复用”，不是复制二进制或共享全局包，而是让多个项目在各自 go.mod 中声明相同版本的 Fiber，并由 Go 工具链统一缓存和解析：
- 所有项目都用
require github.com/gofiber/fiber/v2 v2.56.0→ Go 会从本地$GOPATH/pkg/mod复用同一份已下载的源码 - 若某项目误写成
v2.55.0，Go 会单独缓存该版本，不干扰其他项目 - 升级时应逐个项目运行
go get github.com/gofiber/fiber/v2@v2.57.0，再go mod tidy，避免跨项目隐式升级
注意：go install 或 GOPATH/bin 下的可执行工具（如 fiber CLI）与框架本身无关，Fiber 官方不提供 CLI 工具，勿混淆。
常见错误：误以为 “go get -u” 能自动同步多项目版本
go get -u 只作用于当前模块及其直接依赖，不会扫描或修改其他项目的 go.mod。典型误操作包括：
- 在一个项目里执行
go get -u github.com/gofiber/fiber/v2，就认为所有项目都升级了 → 实际只有当前项目变更 - 手动编辑多个
go.mod把版本改成一样，但没运行go mod tidy→ 构建时仍可能因go.sum不一致而失败 - 用
replace指向本地 fork 的 Fiber 分支做调试，忘记在上线前删掉 → 导致生产环境加载非官方代码
真正可控的多项目版本对齐，靠的是 CI 流程中固定 GO_VERSION 和 FIBER_VERSION 环境变量，再统一执行 go get + tidy。
最易被忽略的一点：Fiber 的 v2 和 v3 是完全不同的 module path，即使函数名一样，也无法通过 alias 或 replace 兼容混用。跨版本迁移必须重写路由注册、中间件签名和上下文使用方式。
