团队协作中必须统一fiber版本与go版本：go.mod需显式require github.com/gofiber/fiber/v2 v2.56.0（非indirect），禁用v3；根目录设go.version为1.21.10，ci校验go版本；构建禁用go get隐式拉取，统一用go build。
团队协作中统一安装 Fiber，核心不是“怎么装”，而是“怎么确保所有人装的版本完全一致且可复现”——go get 默认不锁版本，go.mod 里只记 indirect 或 latest，CI/CD 构建时极易因缓存或 proxy 变动拉到不同 commit，导致本地能跑、流水线报错。
go.mod 必须显式 require + version，不能靠 go get -u
很多人执行 go get github.com/gofiber/fiber/v2 后就以为完事了，但 go.mod 里可能只出现：
require github.com/gofiber/fiber/v2 v2.56.0 // indirect
这个 // indirect 表示它不是你直接依赖，而是被其他包带进来的，下次 go get 其他库可能把它踢掉或升级。正确做法是强制声明为直接依赖：
- 运行
go get github.com/gofiber/fiber/v2@v2.56.0（指定具体 patch 版本，别用@latest） - 检查
go.mod中是否出现不含// indirect的行：require github.com/gofiber/fiber/v2 v2.56.0
- 如果已有
indirect行，先删掉，再重新go get指定版本，Go 会自动重写
v2 还是 v3？生产项目请闭眼选 v2
截至 2026 年 10 月，github.com/gofiber/fiber/v3 仍处于 RC 阶段，文档缺失、中间件生态未对齐、fiber.NewWithCustomCtx 等新 API 在 CI 环境下容易因 Go 版本或构建参数差异行为不一致。团队统一决策应明确：
- 所有新服务、重构项目，
require固定写github.com/gofiber/fiber/v2 v2.56.0（以当前稳定 patch 为准） - 禁止在
go.mod中混用v2和v3路径——Go 视为两个完全无关的模块，import冲突直接编译失败 - 若真要试 v3，必须单独建 repo、独立 CI 流水线，并在 README 顶部加醒目标注：
⚠️ This is v3 preview — not for production
Go 版本也得锁，否则 fiber.New() 都可能 panic
Fiber v2 要求 Go ≥ 1.21+，v2.56.0 实际测试最低兼容 1.21.10；但如果你团队有人用 1.21.0，某些底层 fasthttp 调用会因 syscall 差异 crash。所以：
- 项目根目录放
go.version文件，内容仅一行：1.21.10
- CI 脚本开头加校验：
test "$(go version | cut -d' ' -f3 | tr -d 'go')" = "1.21.10" - 本地开发推荐用
go install golang.org/dl/go1.21.10@latest && go1.21.10 download，避免全局升级影响其他项目
最容易被忽略的一点：团队共享的 Makefile 或启动脚本里，如果写了 go run main.go 却没指定 GOPATH 或 GOBIN，不同人本地 GOPROXY 设置不同（比如有人直连 proxy.golang.org，有人走公司内网镜像），同一行 go get 命令可能拉到不同 commit 的 v2.56.0 —— 表面版本号一样，实际二进制 hash 不同。统一方案是：所有构建流程必须基于 go build + go.mod，禁用任何隐式依赖拉取。
