Golang如何用Air实现热重载_Golang Air热重载教程【实战】-Golang-PHP中文网

air 命令不生效的根源是未在 go.mod 所在目录运行，且默认仅监听 .go 文件；需正确配置 .air.toml 的 watch.include_ext、build.bin 与 build.cmd 路径，并确保构建无语法或 import cycle 错误。

golang如何用air实现热重载_golang air热重载教程【实战】

绝大多数“改了代码没重启”问题，根源是 air 没监控到你编辑的文件——它只从当前工作目录开始递归监听，默认不进 vendor、.git、tmp，也不自动识别子模块路径。

必须在 go.mod 所在目录运行 air，不是 main.go 目录，也不是 IDE 里随便点开的任意子文件夹
如果项目结构是 cmd/myapp/main.go，但 go.mod 在上层，就别 cd 进 cmd/myapp 再跑 air，否则它根本找不到模块依赖
air -c .air.toml 时，配置文件路径必须写对；若 .air.toml 在父目录，而你在子目录执行，air 会静默读错配置甚至 fallback 到默认行为

air 默认只监听 .go 文件，这不是 bug，是设计定位：它专注 Go 代码热重载，不是全栈 Live Reload。模板、配置、静态资源变更不触发重启，得手动加后缀。

在 .air.toml 的 [watch] 或 [build] 段里补上 include_ext = ["go", "yaml", "yml", "html", "tmpl"]
注意：Linux 下 inotify 句柄有限（默认 8192），加太多后缀可能报 inotify limit reached；非必要不加 .log、.md 这类无关后缀
Windows 用户要额外加 .exe 后缀到 bin 字段，比如 bin = "./tmp/main.exe"，否则 fork/exec 会失败

air 只是调度器，真正编译失败是 Go 工具链的事。看到 failed to build, error: exit status 2 别急着调配置，90% 是代码语法或 import cycle 问题。

Golang Naming

Go（Golang）命名规范 — 包括包、构造函数、结构体、接口、常量、枚举、错误、布尔值、接收器、getter/setter、函数等。

下载

打开 build-errors.log（如果你配了），或直接扫终端最后一屏红色输出——重点看是不是 import cycle not allowed 或 undefined: handlerFunc
build.cmd 别写成 go run main.go：它不复用构建缓存，每次都是冷编译，慢且绕过 bin 路径控制
推荐写法：cmd = "go build -o ./tmp/main . && chmod +x ./tmp/main"，尤其在 NFS 或某些容器环境，避免 permission denied

air: failed to kill process: no such process 表面是信号发丢了，实际常因 panic 后子进程僵死，或 Windows 杀毒软件拦截 SIGINT。

在 .air.toml 加 kill_delay = "2s"，给旧进程留出 graceful shutdown 时间
Linux/macOS 下确保 tmp/ 目录有写权限；macOS 若用 Homebrew 装过旧版 air，先 brew uninstall air，否则 air -v 显示新版但实际跑老二进制
不要把 build.bin 和 build.cmd 输出路径搞错，比如 cmd 写 ./tmp/main 却把 bin 写成 main，就会报 exec: "./tmp/main": file does not exist