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）搭个裸机版。
立即学习“go语言免费学习笔记（深入）”；
- 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 这类条件编译开关。 
