fiber.new() 是唯一安全的初始化起点，必须用它创建空实例避免 fiber.default() 的默认中间件拖垮性能；生产项目当前必须用 v2 版本（go get github.com/gofiber/fiber/v2），且 go 版本不低于 1.21；strictrouting 默认开启需谨慎处理尾部斜杠路由；热重载需借助 air 或 reflex 等工具。
fiber.New() 是唯一安全的初始化起点，别用 fiber.Default() 生成模板——它默认加载中间件，上线即拖垮性能。
确认 Go 版本再敲 go get
Fiber v2 要求 go version ≥ 1.21，v3 要求 ≥ 1.24。当前（2026 年 10 月）生产项目必须用 v2：go get github.com/gofiber/fiber/v2。
常见错误现象：undefined: fiber.NewWithCustomCtx 或编译通过但运行 panic——大概率是 Go 版本太低，go get 静默降级拉了不兼容旧分支。
- 执行
go version检查；若低于 1.21，先运行go install golang.org/dl/go1.24@latest && go1.24 download - 验证：运行
go1.24 version，再用go env -w GOROOT=$(go1.24 env GOROOT)切换默认环境 -
go get命令里不要加-u，避免意外升级到 v3 测试版
项目初始化只用 fiber.New()，不依赖任何“模板命令”
Fiber 没有官方 CLI 或 create-fiber-app 类工具。所谓“模板”，就是手动写一个最小可运行结构。
典型误操作：用 fiber.Default() 快速起手，结果日志打满终端、Authorization 头泄露、TTFB 增加 0.3–0.8ms。
- 正确初始化：
app := fiber.New()—— 空实例，零中间件 - 开发期按需加
recover.New()，生产环境关掉堆栈：EnableStackTrace: false - 如需日志，用
logger.New()并精简格式，避开${headers.Authorization}和${body}
StrictRouting 导致路由 404？不是模板问题，是路径注册习惯
注册了 app.Get("/users", handler)，但访问 /users/ 返回 404——这不是模板缺陷，是 Fiber 默认 StrictRouting: true 的行为。
全局关掉 StrictRouting 是危险操作：当同时存在 /users 和 /users/:id 时，/users/123 可能被前者匹配，c.Params("id") 拿不到值。
- 推荐方案：加一层重定向中间件，把结尾带斜杠的请求 301 跳转到无斜杠版本
- 次选方案：显式注册两个路径：
app.Get("/users", handler)和app.Get("/users/", handler) - 别在
fiber.New(&fiber.Config{...})里设StrictRouting: false，除非你完全掌控所有路由定义顺序
热重载不是 Fiber 的事，得靠 air 或 reflex
go run main.go 不支持自动重启，改完代码必须 Ctrl+C 再敲一遍——这不是模板缺失，是 Go 原生命令限制。
真正影响开发效率的是工具链，不是框架本身。
- 用
air：放一个.air.toml，关键字段就三行：cmd = "go build -o ./tmp/main ."、bin = "./tmp/main"、delay = 1000 - 用
reflex：单二进制无依赖，配置更轻量，适合 CI/CD 中复现本地开发流 - 无论用哪个，都必须基于
fiber.New()启动，否则fiber.Default()的日志会刷屏干扰调试输出
fiber.New() 起手、StrictRouting 保留默认、热重载外挂。最容易被忽略的是——所有中间件都得手动加，没有“开箱即用”的安全默认。
