真正有效的清理命令只有 go clean -modcache，它安全、幂等地清空 $gomodcache 中的模块缓存，不影响 go.mod、go.sum 或 vendor，后续构建按需下载缺失或校验失败的模块。
重装 Fiber 不需要“清理缓存”这种操作——Go 模块系统本身不维护类似 npm 或 pip 的全局依赖缓存，go get 拉取的是版本化模块快照，真正要处理的是本地 go.mod 和 go.sum 的一致性，以及可能残留的旧版导入路径。
为什么 go get fiber 不生效或报错
常见现象是执行 go get github.com/gofiber/fiber/v2 后，import 仍报错、IDE 提示找不到包，或运行时 panic “cannot find package”。这不是缓存没清，而是：
- 项目里还留着旧的 v1 导入路径（如
github.com/gofiber/fiber），v1 已归档且不兼容 v2 -
go.mod中记录了冲突版本（比如同时存在v2.0.0和v2.45.0），导致go build无法解析 - 你用了
replace或exclude规则，把 Fiber 指向了本地错误路径或已删目录
正确重装步骤：删 mod + 显式拉取 + 验证导入
别用 go clean -modcache ——它清的是所有模块缓存，影响其他项目，且对 Fiber 重装无实质帮助。只做三件事：
- 删掉当前项目的
go.mod和go.sum（如果确定要从头开始）；或者更稳妥地，运行go get -u github.com/gofiber/fiber/v2@latest强制升级 - 检查所有
import语句，确保全是github.com/gofiber/fiber/v2，绝不能是/v1或无版本后缀 - 运行
go mod tidy，它会自动修正依赖树、删冗余项、更新go.sum
v2 和 v3 混用会导致编译失败
Fiber v2 和 v3 是完全隔离的模块，import 路径不同、API 不兼容。如果你在同一个项目中同时 import v2 和 v3，go build 会直接报错 “mismatched module paths”。尤其注意：
- 第三方库（比如某些中间件）可能仍只支持 v2，强行切 v3 会导致依赖断裂
- v3 要求 Go 1.24+，而你的
go version若是 1.23 或更低，go get会静默降级拉取旧版，表面成功实则引入不兼容代码 - CI/CD 流水线中若未锁定 Go 版本，v3 构建可能在某次 CI 中突然失败
IDE 和编辑器提示异常？不是缓存问题，是 GOPATH 或 go.work 干扰
VS Code 或 Goland 提示 “cannot find package”，但 go run main.go 能跑通，大概率是编辑器没识别到正确的 Go 工作区配置：
- 确认项目根目录下没有残留的
go.work文件，它会覆盖单个项目go.mod，造成路径解析错乱 - 关闭 IDE，终端进项目目录执行
go env -w GOWORK=off，再重启 IDE - VS Code 中检查设置里的 “Go: Use Language Server” 是否启用，禁用后重启可能恢复索引
