Fiber 框架本身不产生需清理的残留文件,所谓“残留”实为 Go 工具链缓存($GOCACHE、$GOPATH/pkg/mod/cache)、IDE 生成的临时目录(.vscode、.idea、__debug_bin)或用户代码中显式调用 os.CreateTemp 等创建的临时文件。

Fiber 框架本身不生成需要特别清理的临时文件,所谓“残留”基本来自 Go 工具链或本地开发环境的缓存行为。直接删 fiber 相关目录或执行“卸载 Fiber”毫无意义——它只是个 Go 包,没有安装器、注册表或后台服务。
Go mod 缓存里藏着 build 中间产物
每次 go run 或 go build 含 github.com/gofiber/fiber/v2 的项目时,Go 会把依赖包(含 Fiber)下载到模块缓存,并在构建过程中生成临时对象文件。这些不会自动清理,尤其频繁改代码重编译后,$GOPATH/pkg/mod/cache/download 和 $GOCACHE 可能堆积数 GB。
-
go clean -cache:清空$GOCACHE(默认~/Library/Caches/go-buildon macOS,%LocalAppData%\go-buildon Windows) -
go clean -modcache:删除所有已下载的模块副本(包括 Fiber 及其间接依赖),下次go run会重新拉取 - 若只清理特定项目残留,进项目根目录执行
go clean -testcache(清测试缓存)+ 手动删./build/或./dist/(如果脚本生成了这些目录)
IDE(如 VS Code / GoLand / PyCharm)自动生成的调试临时文件
启动 Fiber 应用调试时,IDE 可能往项目目录下写 .vscode/、.idea/ 或 __debug_bin 这类文件。它们不是 Fiber 的,但常被误认为“Fiber 留下的”。
- VS Code:检查项目根目录是否存在
.vscode/launch.json生成的临时可执行路径(如"program": "./main.go"对应的隐式构建产物) - PyCharm / GoLand:默认在
$PROJECT_DIR/out/compilation/存构建中间文件;关闭项目后手动删该目录安全 - 通用做法:在项目根目录运行
find . -name "__debug_bin" -o -name ".vscode" -o -name ".idea" -o -name "out" -o -name "target" | xargs rm -rf(macOS/Linux)
运行中 Fiber 进程没退出,导致端口占用或 /tmp 文件残留
Fiber 是纯内存服务,不写磁盘临时文件。但如果你在 handler 里显式调用了 os.CreateTemp、ioutil.TempDir 或日志轮转配置了文件输出,那些才是真残留源。
- 先确认进程是否还在:
lsof -i :3000(macOS/Linux)或netstat -ano | findstr :3000(Windows) - 强制终止:
kill -9 $(lsof -t -i :3000)(macOS/Linux),或用 PID 手动 kill - 检查你代码里有没有类似
os.MkdirAll(os.TempDir()+"/fiber-uploads", 0755)这种手动创建临时目录的逻辑——这才是该删的地方,不是 Fiber 自己干的 - 别碰系统级
/tmp目录本身,除非你明确知道哪些子目录是你的 Fiber 项目创建的
真正要盯住的,从来不是 “Fiber 残留”,而是你自己的代码里有没有 os.WriteFile 到临时路径、IDE 是否开启自动构建缓存、Go 模块缓存是否膨胀——这三处加起来占空间最多,也最容易被当成“框架问题”。


















