必须先确认Go版本，否则go get会静默失败或拉取不兼容旧版；Fiber v2要求Go≥1.21+，v3要求≥1.24+；生产项目应使用v2（go get github.com/gofiber/fiber/v2），v3截至2026年10月仍为测试阶段；务必配置GOPROXY（如goproxy.cn,direct）；初始化必须用fiber.New()而非fiber.Default()，后者默认启用中间件导致性能下降和敏感信息泄露。
必须先确认 Go 版本，否则 go get 会静默失败或拉取错误版本
Go 版本不达标会导致安装失效
Fiber v2 要求 go version 1.21+，v3 要求 go version 1.24+。运行 go version 检查当前版本；若低于要求，go get 可能拉取到不兼容的旧版（比如 v1.x），且无报错提示。
升级示例（以 1.24 为例）：
go install golang.org/dl/go1.24@latest<br>go1.24 download
之后用 go1.24 version 验证，并确保后续命令使用该版本执行。
生产项目应固定使用 v2，而非 v3
v3 截至 2026 年 10 月仍为测试阶段：文档不全、CI/CD 流水线中易因版本漂移出错（如 fiber.NewWithCustomCtx 在某些 patch 版本中行为不一致），且生态工具（如 swagger、jwt 中间件）尚未完全适配。
正确安装命令：
- ✅ 稳定生产环境：
go get github.com/gofiber/fiber/v2 - ⚠️ 仅限尝鲜 v3：
go get github.com/gofiber/fiber/v3，但必须同步用go1.24运行，且import路径不能混用 v2/v3
别漏掉 /v2 或 /v3 后缀——省略会导致拉取 v0 或 v1，编译时 fiber.New 等函数根本不存在。
模块代理配置不是可选项，而是国内开发刚需
直接走官方 proxy.golang.org 在国内常超时或返回 403，导致 go get 卡住或失败。必须显式配置 GOPROXY。
推荐设置（支持 fallback）：
go env -w GOPROXY=https://goproxy.cn,direct
验证是否生效：
go env GOPROXY
常见错误：
- 只设
https://goproxy.cn不加direct：私有模块无法拉取 - 设成
https://proxy.golang.org：多数情况请求失败 - 在项目目录下执行
go mod init前未配置：首次go mod tidy仍会尝试直连
初始化 Fiber 实例时别碰 fiber.Default()
fiber.Default() 是个陷阱：它默认启用 Logger、Recover、RequestID 中间件，每秒写数百条含敏感头（如 Authorization）的日志，I/O 直接拖垮 QPS，TTFB 增加 0.3–0.8ms。
正确做法是：
- 始终用
fiber.New()创建空实例 - 按需手动添加中间件，例如 debug 环境才加
logger.New() - 生产环境关掉堆栈：
recover.New(recover.Config{EnableStackTrace: false})
开发阶段可用 fiber.Default() 快速验证路由逻辑，但上线前必须替换并清理中间件列表——这个切换点极易被忽略，压测时才暴露性能断崖。
