Fiber 是 Go 语言 Web 框架,需用 go get 安装而非 pip;必须先安装 Go 1.20+、初始化 go.mod、导入并使用 fiber 包才能构建运行。

直接装 fiber 不行,它必须在 Go 环境里用 go get 安装,不是 Python 的 pip 包 —— 这是新手最容易卡住的第一步。
确认本地已安装 Go 1.20+
Fiber 依赖 fasthttp,而后者要求 Go 1.20 或更高版本。运行以下命令验证:
go version
如果输出低于 go1.20,需升级 Go(macOS 推荐 brew install go;Windows 从官网下载安装包;Ubuntu 可用 sudo apt install golang-go)。注意:不要用系统自带的旧版 golang 包,它常滞后多年。
创建并进入项目目录,初始化模块
Fiber 是 Go 模块化项目,不能裸跑。必须先有 go.mod 文件:
- 新建空目录:
mkdir myfiber && cd myfiber - 初始化模块:
go mod init myfiber(模块名可自定义,但不能含空格或大写字母) - 此时目录下会出现
go.mod,内容类似module myfiber+go 1.21
这一步漏掉会导致后续 go get 报错 no Go files in directory 或无法解析导入路径。
执行 go get 安装 Fiber v2
运行命令安装稳定版:
go get github.com/gofiber/fiber/v2
常见问题与应对:
-
unrecognized import path "github.com/gofiber/fiber/v2":检查是否在正确目录(有go.mod)、网络是否能访问 GitHub(国内可配 GOPROXY,如export GOPROXY=https://goproxy.cn,direct) - 安装后
go.mod里没出现 fiber 行:说明未真正引用,需在main.go中至少 import 一次,Go 才会自动写入依赖 - 想锁定小版本(如 v2.52.0):用
go get github.com/gofiber/fiber/v2@v2.52.0
验证是否能正常构建和运行
写一个最小可运行文件 main.go:
package main
import "github.com/gofiber/fiber/v2"
func main() {
app := fiber.New()
app.Get("/", func(c *fiber.Ctx) error {
return c.SendString("ok")
})
app.Listen(":3000")
}
然后执行:
go run main.go
如果终端打印 Listening on http://localhost:3000,且 curl http://localhost:3000 返回 ok,说明环境已通。注意:不需要额外启动虚拟环境或激活 Python venv —— Fiber 是纯 Go 项目,和 Python 环境完全无关。
容易被忽略的是:Fiber 不提供全局 CLI 工具,也不生成脚手架目录结构;所有路由、中间件、错误处理都靠手写代码组织。别指望像 Django 或 FastAPI 那样自动管理配置文件或迁移命令。











