17370845950

go run 不能满足热重载需求，因为它每次执行都重新编译 main 包并启动新进程，不监听文件变化、不管理旧进程，需手动中断重启；官方未内置该功能，推荐使用 air 工具实现零配置热重载。

为什么 go run 不能满足热重载需求

因为 go run 每次执行都会重新编译整个 main 包并启动新进程，它本身不监听文件变化，也不管理旧进程生命周期。你改完代码必须手动 Ctrl+C 再敲一遍命令，这对快速迭代是硬伤。

• Go 官方没有内置热重载工具，这是设计使然——强调构建确定性与部署简洁性
• 第三方热重载工具本质都是「文件监听 + 进程启停控制」，不是语言特性
• 注意：热重载只适用于开发阶段；生产环境严禁使用这类工具

推荐用 air 实现零配置热重载

air 是目前最轻量、兼容性最好、默认行为最贴近直觉的 Go 热重载工具。它通过 .air.toml 支持细粒度控制，但多数项目连配置文件都不需要。

• 安装：

  go install github.com/cosmtrek/air@latest

• 在项目根目录直接运行：

  air

  （自动找 main.go 或 cmd/ 下的入口）
• 默认监听 *.go、**/*.go，修改后秒级重启，终端输出带颜色错误提示
• 遇到编译失败时，旧进程不会被杀掉，HTTP 服务仍可响应（避免调试中断）

air 配置

常见陷阱与绕过方式

多数人卡在自定义构建命令或忽略某些路径，导致改了不生效或反复重启。

• 如果你用了 go mod vendor，需在 .air.toml 中显式启用：vendor = true
• 若项目结构含多个 main（如 cmd/api 和 cmd/worker），必须指定：main_cmd = "go run cmd/api/main.go"
• 忽略日志或测试文件能减少误触发：exclude_dir = ["logs", "tests", "fixtures"]
• Windows 下路径分隔符写错会导致监听失效——一律用正斜杠 /，哪怕在 Windows 上

不用 air 时的最小可行替代方案

如果因安全策略或 CI 环境限制无法装第三方工具，可用 shell 脚本+inotifywait（Linux/macOS）或 fswatch（macOS）搭个裸机版。

• Linux 示例（需先 apt install inotify-tools）：

  while inotifywait -e modify,create,delete --exclude '\.swp$' -r ./; do go build -o app . && ./app & PID=$!; sleep 0.1; kill $PID 2>/dev/null; done

• 该脚本问题明显：无错误捕获、进程残留风险高、Windows 不可用——仅作临时救急
• 真正要长期用，还是回归 air；它的 tmp_dir 和 pid_file 机制已解决绝大多数竞品的进程僵死问题

热重载本身不复杂，难的是让「编译→启停→日志→错误保留」这一串动作稳定衔接。很多人试了两三个工具就放弃，其实只是没调对 air 的 bin 路径或忽略了 build_flags 里要加 -tags=dev 这类条件编译开关。