Fiber 没有官方脚手架,需手动用 go mod init + fiber.New() 初始化项目;go get 只安装框架不生成文件;推荐三步搭建合规结构,避免默认配置引发的线上问题。

Fiber 没有官方维护的脚手架工具(如 create-fiber-app 或 fiber-cli),所谓“Fiber 脚手架”是开发者自行封装的模板或构建流程,不是框架自带能力。
你真正需要的,是快速初始化一个可部署、符合生产规范的 Fiber 项目结构——这靠手动几行命令就能完成,不需要额外 CLI 工具。
go get 安装的是框架本身,不是脚手架
go get github.com/gofiber/fiber/v2 只下载框架代码和依赖,不生成任何文件、不创建目录、不注入配置。它和 npm install express 类似:装完只是有了库,没给你 app.js。
常见误解是把第三方轻量模板(比如 GitHub 上叫 fiber-starter 的 repo)当成“官方脚手架”,但这些:
- 不受 Fiber 团队维护
- 往往基于过时的
fiber.Default()初始化方式 - 默认开启
Logger和StrictRouting: false,直接用于生产会出问题
用 go mod init + fiber.New() 三步搭出合规项目
这才是实际开发中最可控、最不易踩坑的方式:
- 运行
go mod init myapp初始化模块 - 创建
main.go,内容为:package main
import "github.com/gofiber/fiber/v2"
func main() { app := fiber.New() // 不要用 fiber.Default() app.Get("/", func(c fiber.Ctx) error { return c.SendString("ok") }) app.Listen(":3000") }
- 运行
go run main.go验证通路,再按需加路由、中间件、校验逻辑
这样起步,你从第一天就避开日志泄露、TTFB 延迟、路径匹配异常等高频线上问题。
想批量生成项目结构?自己写个 shell 脚本更可靠
与其依赖不可控的第三方 CLI,不如用 10 行 bash 封装常用结构:
- 自动创建
handlers/、middleware/、routes/目录 - 注入带
fiber.New()和空中间件列表的main.go - 写好
.gitignore(排除/tmp、/dist、go.sum锁定) - 加上
build.sh:预设CGO_ENABLED=0 GOOS=linux GOARCH=amd64 go build -ldflags="-s -w"
真正的复杂点不在“怎么生成文件”,而在于:
所有自动生成的内容,必须默认禁用 fiber.Default()、保留 StrictRouting: true、不写死日志中间件、不自动启用 HTTPS 监听——这些才是上线前最容易被脚手架悄悄埋雷的地方。











