需安装go 1.25+版本,配置goproxy为https://goproxy.cn,执行go mod init后运行go get github.com/gofiber/fiber/v2,再用示例代码验证服务是否在:3000正常响应。

要在本地搭建可运行Fiber框架的Go开发环境,必须先满足Go语言版本要求、正确安装Go SDK,并配置好模块代理与环境变量,否则后续执行go get会失败或拉取到不兼容的v3测试版。
确认并安装匹配的Go版本
打开终端,运行go version。若显示低于go1.24(如go1.22.6),则无法安全使用Fiber v3;若为go1.25及以上,可同时支持v2稳定版与v3预发布版。【Fiber v3强制要求Go 1.25+,而生产项目应优先选用v2.x稳定版】
前往https://www.php.cn/link/81836b7cd16991abb7febfd7832927fd下载对应系统架构的go1.25.0或更高版本安装包,Windows用户选MSI,macOS选pkg,Linux选tar.gz并解压至/usr/local后更新PATH。
初始化Go工作区与模块代理
新建项目目录,例如mkdir fiber-demo && cd fiber-demo,然后执行go mod init fiber-demo生成go.mod文件。
国内用户必须配置模块代理,否则go get大概率超时或返回403:go env -w GOPROXY=https://goproxy.cn,direct。这一步不可跳过,跳过将导致github.com/gofiber/fiber/v2无法下载。
安装Fiber框架(v2稳定版)
执行命令:go get github.com/gofiber/fiber/v2。注意不要加-u参数——v2已进入维护期,-u可能意外升级到破坏性变更的预发布标签。
安装完成后,go.mod中应出现类似github.com/gofiber/fiber/v2 v2.52.0的行,表示已锁定稳定版本。若看到v3.0.0-rc字样,说明代理未生效或手动指定了v3,需删掉go.mod和go.sum重来。
验证环境是否就绪
在项目根目录创建main.go,粘贴以下代码:
package main<br>import "github.com/gofiber/fiber/v2"<br>func main() {<br> app := fiber.New()<br> app.Get("/", func(c *fiber.Ctx) error {<br> return c.SendString("Fiber ready!")<br> })<br> app.Listen(":3000")<br>}
保存后执行go run main.go,终端输出Listening on :3000即表示环境配置成功。此时访问http://localhost:3000应返回纯文本Fiber ready!。











