Fiber 是纯 Go module,无全局安装概念,“卸载”实为清理缓存和 vendor;重装需更新 go.mod 中的 require 行、修正 import 路径,并注意 v2/v3 不兼容及 StrictRouting 行为变化。

别卸载——Fiber 是纯 Go 包,没有全局安装概念,所谓“卸载”只是清理依赖缓存和 vendor(如有),重装本质是 go get 拉新版本 + 清理旧 import 路径残留。
为什么不能像 npm uninstall 那样“卸载” Fiber
Fiber 不是系统级工具或 CLI,它只是 Go module。你项目里用的其实是 github.com/gofiber/fiber/v2 或 github.com/gofiber/fiber/v3 这两个独立模块路径。Go 的 module 机制不会“安装到全局”,只在 go.mod 中声明、在 vendor/(如有)中快照、在本地 $GOPATH/pkg/mod 缓存。
常见误解:删掉 vendor/ 或 go clean -modcache 就算“卸载”了——其实只是清缓存,不影响代码逻辑;真正要动的是 go.mod 里的 require 行和源码里的 import 路径。
- 删
vendor/:仅影响离线构建,不改变依赖关系 - 运行
go clean -modcache:清本地 module 缓存,下次go build会重新下载,但不会自动更新版本 -
go get不带-u:默认只升级 minor/patch,不会升 v2 → v3
安全重装 Fiber v2(生产推荐)
目标:确保项目用的是干净的 v2 最新版(如 v2.52.0),无 v3 残留、无跨版本 import 混用。
- 检查当前版本:
go list -m github.com/gofiber/fiber/v2 - 强制更新到最新 v2:
go get github.com/gofiber/fiber/v2@latest(注意没加-u,避免意外升 v3) - 确认
go.mod中只有这一行:github.com/gofiber/fiber/v2 v2.52.0(以实际 latest 为准) - 搜索整个项目,删掉所有
import "github.com/gofiber/fiber/v3"——v2 和 v3 的 import 路径完全不兼容,混用会导致编译失败 - 如果用了
fiber.Default(),按规范替换成fiber.New()并显式加中间件(见知识库“初始化项目”部分)
想试 v3?必须同步升级 Go 并隔离环境
v3 不是 v2 的补丁升级,它是重构版:要求 Go 1.24+,API 有 Breaking Change(如 fiber.Ctx 方法签名调整),且生态工具(如 fiber-jwt)尚未全面适配。
- 先确认 Go 版本:
go version,若低于go1.24,必须执行:go install golang.org/dl/go1.24@latest && go1.24 download - 新建测试分支或目录,避免污染主项目
- 改
go.mod:require github.com/gofiber/fiber/v3 v3.0.0-xxx(别用@latest,v3 当前无正式 release) - 所有 import 必须改为:
import "github.com/gofiber/fiber/v3",v2 的 import 会直接报错 - 注意:v3 中
fiber.Default()已移除,RebuildTree()成为公开 API,但文档和 CI 支持仍不稳定
最常被忽略的一点:重装后别忘了检查 StrictRouting 行为是否符合预期——v2 和 v3 默认都开启,但如果你之前靠关掉它绕过路径斜杠问题,现在得用重定向中间件来解,否则上线后 /users/ 会持续 404。











