Air启动后代码修改无反应,主要因工作目录错误或.air.toml中watch路径配置不当;默认仅监听当前目录下.go文件,若main.go在子目录(如cmd/app/main.go)则不会触发重建。

为什么 air 启动后代码改了没反应?
大概率是工作目录不对,或者 .air.toml 里监控路径写死了。默认 air 只监听当前目录下的 *.go 文件,如果你的 main.go 在子目录(比如 cmd/app/main.go),它根本不会触发重建。
实操建议:
立即学习“go语言免费学习笔记(深入)”;
- 启动前先
cd到项目根目录(即包含go.mod的那层),不是main.go所在目录 - 用
air -c .air.toml显式指定配置,避免读错位置 - 检查
.air.toml中的root字段是否被手动改过,留空或设为"."最稳妥 - 如果用了 Go Module,确保
GO111MODULE=on已生效(go env GO111MODULE看一眼)
air 配置文件里哪些字段真会影响热重载?
真正关键的就三个:监控范围、构建命令、忽略规则。其他像日志颜色、通知弹窗只是锦上添花,不配也不会崩。
实操建议:
立即学习“go语言免费学习笔记(深入)”;
-
build.cmd推荐写成"go build -o ./tmp/main .",别用go run—— 它无法复用编译缓存,改一次等三秒 -
build.bin必须和build.cmd输出路径一致,比如上面写了./tmp/main,这里就得填"./tmp/main" -
watch.excluded_dirs加上["tmp", "vendor", ".git"],否则每次git status都可能误触发 - 别碰
build.delay默认值(1000ms),调太小会导致保存瞬间文件还没写完,编译失败
修改模板或静态文件时 air 不重启?
因为默认只监听 *.go,HTML/CSS/JSON 这类非 Go 文件压根不在 watch 列表里。这不是 bug,是设计如此 —— air 定位是 Go 代码热重载,不是全栈 Live Reload。
实操建议:
立即学习“go语言免费学习笔记(深入)”;
- 在
.air.toml的watch.extensions里补上需要的后缀,比如["go", "html", "tmpl", "yaml", "json"] - 如果模板改动不涉及逻辑(比如只改文案),可以考虑让程序自己监听文件变化并热加载,而不是依赖
air重启进程 - 注意:加太多后缀会增加 inotify 负担,Linux 下默认单进程最多监控 8192 个文件,超了会报
inotify limit reached
Windows 上 air 报 fork/exec: permission denied 怎么办?
本质是 Windows 权限模型和 Go 构建产物不兼容:air 试图直接执行生成的二进制(比如 main.exe),但某些杀毒软件或组策略会拦截未签名的可执行文件运行。
实操建议:
立即学习“go语言免费学习笔记(深入)”;
- 把
build.bin改成带.exe后缀,比如"./tmp/main.exe",同时build.cmd对应改成"go build -o ./tmp/main.exe ." - 关掉 Windows Defender 实时防护试试(临时),看是否缓解 —— 如果好了,就把
tmp目录加进排除列表 - 更稳的方案是换用
go install github.com/cosmtrek/air@latest(不是go get),新版对 Windows 的 exec 处理更健壮
热重载不是魔法,air 只负责“检测→构建→启动”,中间任何一环卡住(路径、权限、构建失败、端口占用),它都不会自动兜底。最常被忽略的是:改完配置没重启 air 进程本身。










