Go模块未激活是Fiber导入报错主因，需检查go.mod是否存在、路径是否一致，并确保import含/v2后缀、有实际调用且GO111MODULE=on。
导入报错不是 Fiber 没装好，而是 Go 模块系统没认出你这个项目——go.mod 缺失或路径不一致是主因。
检查 go.mod 是否存在且内容正确
没有 go.mod，Go 就不会把 github.com/gofiber/fiber/v2 当作当前项目的依赖，IDE 和 go build 都会飘红。
- 在项目根目录运行
go list -m：如果报go: not using modules或无输出，说明模块未激活 - 执行
go mod init your-module-name（模块名建议与后续 import 路径一致，如example.com/myapp） - 再运行
go get github.com/gofiber/fiber/v2@latest，确认go.mod中出现github.com/gofiber/fiber/v2 v2.50.0类似行 - 别用
go get -u github.com/gofiber/fiber（漏掉/v2后缀会导致拉取 v1 兼容版，编译失败）
核对 import 语句和文件系统路径是否字面匹配
Fiber v2 的导入路径必须带 /v2，且整个字符串要和 go.mod 声明、磁盘目录结构完全一致——差一个字母、多一个空格都会导致找不到包。
- 错误写法：
import "github.com/gofiber/fiber"→ 缺/v2，Go 模块系统直接拒绝解析 - 正确写法：
import "github.com/gofiber/fiber/v2" - 如果你的 main.go 在
cmd/server/main.go，而想导入本地中间件，不能写import "./middleware"，得写成import "example.com/myapp/middleware"（即模块名 + 相对路径） - 用
go mod graph | grep fiber查看实际解析到的版本，避免本地缓存干扰
确认 GOPATH 和 GO111MODULE 没冲突
手动设过 GO111MODULE=off 或残留 GOPATH 配置，会让 Go 切换回老式非模块模式，和 IDE 的模块索引打架。
- 运行
go env -w GO111MODULE=on和go env -w GOPROXY=https://goproxy.cn,direct - 删掉 IDE（如 Goland）里 Project Settings > Go > GOPATH 的自定义配置
- 重启 IDE 并刷新项目（Goland 是 File > Reload project；VS Code 是 Ctrl+Shift+P > “Go: Reload Packages”）
- 检查
go env GOMOD输出是否为当前项目下的go.mod绝对路径
验证 fiber.New() 调用是否触发了模块依赖加载
只写 import "github.com/gofiber/fiber/v2" 不足以让 Go 解析依赖——必须有代码实际引用该包的符号，否则 go mod tidy 可能把它从 require 中剔除。
- 确保
main.go里有类似app := fiber.New()或fiber.New().Get(...)的调用 - 如果只是 import 但没用，运行
go mod tidy后go.mod里 fiber 行可能消失 - 临时加一行
_ = fiber.App{} // force import可辅助诊断，但上线前删掉 - 别依赖
go run main.go自动补依赖——它可能跳过模块校验，掩盖问题
最容易被忽略的是：IDE 显示的红线可能来自缓存而非真实错误。删掉 go.mod 和 go.sum，重新 go mod init + go get + go mod tidy，比反复调参数更可靠。
