fiber v3 要求 go 1.25+，需先升级 go 版本并用 go mod init 初始化模块，再执行 go get github.com/gofiber/fiber/v3；验证时须用 v3 导入路径和 func(c fiber.ctx) error 签名，ctx 是接口而非指针。
Go Fiber 框架本身不依赖外部 C 库或复杂构建工具，安装就是一条 go get 命令的事，但实际跑起来常卡在 Go 版本、模块初始化或 v3 兼容性上——尤其如果你刚从 Node.js 或 Gin 切过来。
确认 Go 版本是否满足最低要求
Fiber v2 要求 Go 1.19+，而 Fiber v3 已强制要求 Go 1.25+。当前（2026年10月）v3 是稳定主力版本，直接用 v3 更稳妥：
- 运行
go version查看当前版本，若低于go1.25，必须先升级 - 升级方式推荐用官方下载器：
go install golang.org/dl/go1.25@latest && go1.25 download - 别用系统包管理器（如 apt/yum）装的 Go，容易版本滞后且 PATH 冲突
初始化模块并安装 Fiber v3
不能跳过 go mod init 直接 go get，否则会污染全局 GOPATH 或导致依赖解析失败：
- 新建项目目录后，先执行
go mod init myapp（模块名建议小写、无下划线） - 再运行
go get github.com/gofiber/fiber/v3——注意是/v3，不是/v2 - 如果提示
no required module provides package，说明模块未初始化或go.mod未生成，回退检查上一步
验证安装是否真正可用
装完不等于能跑，常见“安装成功但运行报错”是因为导入路径或函数签名已变：
- v3 中
fiber.New()返回*fiber.App，但中间件和路由 handler 的参数类型有调整 - 最简验证代码必须用 v3 写法：
import "github.com/gofiber/fiber/v3"，且 handler 签名是func(c fiber.Ctx) error（不是*fiber.Ctx） - 别复制 v2 示例代码，比如
c.Params("id")在 v3 里仍可用，但c.Locals默认行为有变化，首次调试建议只测c.SendString
v3 的 fiber.Ctx 是接口而非指针，这是性能优化的关键，也是最容易因惯性写错的地方：传参时别加 *，调用方法时也别解引用。
