必须先确认go版本是否达标：fiber v2要求go≥1.21，v3要求go≥1.24；低于对应版本时go get可能静默降级或失败，需用go version验证并同步更新goroot、path及清理缓存。
必须先确认 Go 版本是否满足 Fiber 所需的最低要求，否则 go get 会静默失败或拉取错误版本。
检查当前 Go 版本是否达标
运行 go version 查看本地版本。Fiber v2 支持 Go 1.21+，v3 要求 Go 1.24+。如果你项目依赖 github.com/gofiber/fiber/v2，但本机是 Go 1.20，则 go get 可能降级到不兼容的 v1.x 或直接卡住——它不会报错，只会给你一个“看似成功”的旧版。
- 用
go version确认输出类似go version go1.24.3 darwin/arm64 - 若低于目标版本（比如想用 v3 却只有 1.23），别跳过升级，直接装 Fiber 无意义
- 注意：CI/CD 环境、Docker 构建镜像里的 Go 版本也得单独检查，不能只信本地
为什么不能靠 go get -u 自动兜底
go get -u github.com/gofiber/fiber/v2 看似省事，但 Go 模块解析器在低版本 Go 下可能忽略 /v2 后缀，误拉取 v1 主干；而高版本 Go（如 1.24+）又可能因模块兼容性策略拒绝安装 v2 包，除非显式指定路径。
- 正确做法是：先确保 Go 版本 ≥ 目标 Fiber 版本要求，再执行
go get github.com/gofiber/fiber/v2（不带-u） -
-u会尝试升级所有间接依赖，可能把fasthttp升到不兼容的快照版，引发 panic: “invalid memory address” 类运行时错误 - 如果
go.mod已存在，还应核对go行声明的版本（如go 1.24）是否与实际一致
升级 Go 版本时容易踩的坑
升级不是替换二进制就完事。GOROOT 和 PATH 错位、旧构建缓存残留、GOTOOLCHAIN 未同步，都会导致 go build 表现异常，让你误以为是 Fiber 安装失败。
- 升级后务必运行
go env GOROOT和which go，确保两者指向同一目录 - 执行
go clean -cache -modcache，否则旧版本缓存可能污染新构建 - 若用
GOTOOLCHAIN=go1.24这类显式工具链，要确认项目根目录下go.work或go.mod里没硬编码冲突的版本 - 交叉编译场景下（如本地 macOS 编译 Linux 二进制），
GOOS/GOARCH不影响版本检查，但 CGO_ENABLED=0 必须配合新版 Go 使用，否则证书池加载失败
最常被忽略的是：团队协作时，有人本地升级了 Go，但 .gitignore 里漏掉了 go.sum 更新，或者 CI 配置仍用旧版 Docker 镜像 —— 这时候 go get 在本地成功，在流水线却失败，问题根源根本不在 Fiber。
