Fiber 不支持全局安装，本质是 Go module，需先 go mod init 初始化模块，再 go get github.com/gofiber/fiber/v2 下载依赖，且要求 Go ≥ 1.21、导入路径含 /v2、实例化用 fiber.New()。
直接上结论：Fiber 不是系统级软件，没有“环境搭建”这回事——它就是一个 Go module，go get github.com/gofiber/fiber/v2 一行命令完事，但前提是 Go 版本 ≥ 1.21、模块已初始化、路径写对。90% 的“安装失败”其实卡在这三处。
确认 Go 版本是否 ≥ 1.21（v2）或 ≥ 1.24（v3）
Fiber v2 要求 Go ≥ 1.21，v3 要求 ≥ 1.24。当前（2026 年 11 月）v2 是生产唯一推荐版本，v3 仍属测试阶段，文档和中间件生态未完全就绪。
运行以下命令检查：
go version
若输出类似 go version go1.20.15 darwin/arm64，说明不满足 v2 最低要求，必须升级：
立即学习“go语言免费学习笔记（深入）”；
- 执行
go install golang.org/dl/go1.21@latest && go1.21 download - 再运行
go1.21 version确认生效 - 别用
apt/brew升级 Go，容易 PATH 冲突或版本滞后
低于 1.21 时执行 go get github.com/gofiber/fiber/v2 可能静默成功，但实际拉取的是兼容旧版分支，后续调用 fiber.New() 会编译报错。
必须先 go mod init，再 go get
Fiber 是 Go module，不是全局工具。跳过模块初始化直接 go get，会导致依赖无法解析、go.mod 缺失、IDE 提示 “unresolved reference”。
正确流程：
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
- 新建项目目录，运行
go mod init myapp（模块名小写、无下划线） - 再执行
go get github.com/gofiber/fiber/v2（注意后缀/v2，不是/v3或无后缀） - 检查
go.mod是否出现这一行：github.com/gofiber/fiber/v2 v2.50.0
如果提示 no required module provides package，说明模块未初始化或当前不在模块根目录下。
导入路径和初始化必须匹配 v2 规范
装完不等于能跑。常见“编译通过但运行 panic”是因为导入路径或初始化方式错配：
- 导入语句必须是：
import "github.com/gofiber/fiber/v2"，不能漏/v2 - 初始化必须用
app := fiber.New()，不是fiber.Default() - 路由 handler 签名必须是：
func(c *fiber.Ctx) error（注意是指针类型） - v3 的
func(c fiber.Ctx) error（接口类型）不兼容 v2，混用会报类型错误
最简验证代码：
package main
import (
"log"
"github.com/gofiber/fiber/v2"
)
func main() {
app := fiber.New()
app.Get("/", func(c *fiber.Ctx) error {
return c.SendString("ok")
})
log.Fatal(app.Listen(":3000"))
}
运行前务必删掉所有 fiber.Default()、import "github.com/gofiber/fiber"（无版本后缀）这类 v1 遗留写法。
为什么 fiber.New() 是唯一安全起点
fiber.Default() 默认启用 logger、recover、requestid 三个中间件。开发时方便，但上线后立刻暴露问题：
- 日志中间件默认记录完整请求头（含
Authorization），高并发下磁盘 I/O 打满 -
recover默认打印全量堆栈，生产环境毫无必要且泄露敏感信息 - TTFB 实测增加 0.3–0.8ms，链路每多一层中间件，性能损耗就不可忽略
正确做法是空实例起步：app := fiber.New()，再按需显式添加中间件，例如只在调试环境加日志：
if os.Getenv("ENV") == "dev" {
app.Use(logger.New())
}
最容易被忽略的点是：fiber.New() 返回的 *fiber.App 是干净的，但所有路由路径必须以 / 开头（如 "/users"），写成 "users" 会静默匹配失败——Fiber 不报错，只是永远不响应。
