Air是Go生态最主流、维护活跃的本地热重载工具,通过监听文件变更→自动编译→杀旧启新实现进程重启式热重载,支持细粒度配置、彩色日志、多扩展名监听及子进程管理,专为开发提效设计,不适用于生产环境。

Fiber 本身不支持热重载,必须靠外部工具监听文件变化并重启进程;Go 没有 Python/Node.js 那样的运行时模块热替换机制,所有“热重载”本质都是 kill + restart。
为什么 air 是当前最稳的选择
Go 社区主流方案是 air,它比 fresh 或自写 shell 脚本更可靠:能识别 .go、.tmpl、.mod 变更,自动 kill 子进程(避免端口占用),且支持自定义构建命令和忽略路径。
- 安装:
curl -sSfL https://raw.githubusercontent.com/cosmtrek/air/master/install.sh | sh -s -- -b $(go env GOPATH)/bin - 必须在项目根目录放
.air.toml,否则用默认配置会误杀日志或跳过vendor/目录 - 关键配置项:
bin = "./app"(指定生成的二进制名),delay = 1000(毫秒级重建延迟,防频繁触发) - 若用
fiber.New()启动后没加log.Fatal(app.Listen(...)),air重启时可能残留 goroutine 导致端口 bind 失败
air 配置里最容易漏掉的三处
默认配置下 air 不会监听 go.mod 或 config.yaml,改依赖或配置文件后服务不会重启——这导致很多“改了配置不生效”的假象。
- 在
.air.toml的[build]段显式加:include_ext = ["go", "mod", "yaml", "yml"] -
exclude_dir = ["node_modules", "tmp", ".git"]必须写全,否则air会扫描整个node_modules导致 CPU 爆满 - 若项目含 cgo 或需要交叉编译,
cmd = "go build -o ./app ."要写绝对路径,不能用go run .—— 后者每次启动都重新编译,热重载延迟飙升到 3 秒+
用 watchexec 替代 air 的适用场景
当项目混用 Go + TypeScript(比如 Fiber API + Next.js 前端联调),air 无法跨语言监听;这时用 watchexec 统一管理更干净。
- 安装:
brew install watchexec/tap/watchexec(macOS)或sudo apt install watchexec(Ubuntu) - 命令:
watchexec -e 'go,mod,yaml' --on-change 'kill $(lsof -ti:3000) 2>/dev/null || true; go build -o app . && ./app' - 注意:
lsof -ti:3000只杀监听 3000 端口的进程,若你用:8080得同步改;Windows 用户需换Get-NetTCPConnectionPowerShell 命令 - 别把
watchexec当长期守护进程用——它不处理 panic 后的自动恢复,出错就停,适合开发机,不适合 CI/CD
真正要警惕的是“伪热重载”:比如只监听 main.go 却忽略 handlers/ 下的路由文件,或者用 go run . 导致每次重启都重新下载依赖。Fiber 的性能优势全在启动后,别让热重载工具拖慢你的反馈循环。











