Go语言热重载如何配置_Go语言开发调试操作教程【推荐】-Golang-PHP中文网

air默认只监听.go文件，改config.yaml或html无反应；必须在[watch]和[build]两节均配置include_ext=["go","yaml","yml","html","tmpl"]，且build.bin与build.cmd路径严格一致，否则启动失败或不重载。

go语言热重载如何配置_go语言开发调试操作教程【推荐】

Go 本身不支持热重载，必须靠第三方工具实现；air 是目前最稳定、配置最清晰的选择，但默认行为只监听 .go 文件，绝大多数“没反应”问题都出在监听范围或构建路径配置错误上。

这不是 bug，是默认配置根本没注册这些文件的 inotify 监听。air 默认只 watch .go 后缀，连 go.mod 都不看，更别说 YAML、HTML、TOML 了。

必须在 .air.toml 的 [watch] 和 [build] 两节都显式声明：include_ext = ["go", "yaml", "yml", "html", "tmpl"]
include_ext 是白名单，不是追加——漏写 "go"，连 main.go 都不会触发重建
改完配置后必须手动重启 air 进程，它不热加载自身配置
如果项目结构是 cmd/myapp/main.go，必须在该目录下运行 air，否则入口识别失败

这是 air 启动失败最常卡住的地方：air 按 build.bin 去执行，但 build.cmd 没真把二进制写到那儿，就会报 exec: "./tmp/main": file does not exist。

Go语言（Golang）1.26.0

Go语言（Golang）1.26.0版本官方下载，版本号 1.26.0，适合旧项目维护、兼容性测试和指定版本开发环境搭建。

下载

build.cmd = "go build -o ./tmp/main ." → 输出路径是 ./tmp/main
build.bin 必须严格等于 "./tmp/main"，不能是 "tmp/main"（少点）或 "./tmp/main.exe"（Windows 没配后缀）
Linux/macOS 上确保 ./tmp 可写，且生成的二进制有可执行权限：build.cmd = "go build -o ./tmp/main . && chmod +x ./tmp/main"
Windows 用户建议用 build.bin = "./tmp/main.exe"，对应 build.cmd = "go build -o ./tmp/main.exe ."

本质是 air 发了 SIGTERM，但你的 Go 程序没处理它，旧进程就卡在那儿了，端口实际没释放。

必须在 main() 中显式捕获 os.Interrupt 或 syscall.SIGTERM，调用 http.Server.Shutdown()
检查 build.delay 是否设得太小（比如 100），新进程还没起来、旧进程还没关完，端口就被抢
临时清理残留：pkill -f 'tmp/main'（macOS/Linux）或 taskkill /F /IM main.exe（Windows）
别依赖 air init 生成的默认配置——它不含 kill_delay，而某些框架启动慢，需要留出关闭时间

air 只负责代码变更后重启进程，它不管配置文件是否生效；配置热加载必须你自己实现，viper.WatchConfig() 只发通知，不自动重读、不自动更新结构体。

必须在 viper.OnConfigChange 回调里显式调用 viper.ReadInConfig() 和 viper.Unmarshal(&cfg)
直接赋值全局变量 cfg = newCfg 是危险操作：结构体字段多时，goroutine 可能读到部分新、部分旧的值
推荐用 atomic.Value 存配置指针：globalConf.Store(&newCfg) 写入，globalConf.Load().(*Config) 读取
Linux 容器中常见 No space left on device 报错——其实是 inotify 句柄耗尽，需调高 fs.inotify.max_user_watches