go run 不支持热编译，每次均为全新编译启动；需用 air 等工具实现监听文件变化、自动重启，且须配置监听 .mod/.env 等文件并处理信号以避免端口占用。
go run 不能热编译，别白试了
Go 官方 go run 本身不支持热编译——它每次都是全新编译+启动，没有监听文件变化、自动重启的逻辑。你改完代码按保存，服务不会动；手动 Ctrl+C 再 go run main.go，才是它的真实行为。想靠它实现“改保存就刷新”，注定失败。
常见错误现象：go run main.go 后修改代码，浏览器刷新还是旧响应；终端没报错，但就是不生效。
- 根本原因：Go 编译模型是静态构建，
go run只是把编译+运行封装成一步，并非开发服务器 - 替代思路：必须引入第三方工具接管“监听 → 编译 → 杀旧进程 → 启新进程”整条链路
- 注意兼容性：
air和reflex都依赖fsnotify，在某些 NFS 或 Docker 挂载卷下可能失灵（尤其是 WSL2 默认挂载）
用 air 最省事，但得配好 .air.toml
air 是目前最主流的 Go 热编译工具，轻量、跨平台、配置直观。但它默认只监听 .go 文件，且对 go.mod 或 .env 变更不敏感——这些恰恰是开发中常改又容易被忽略的点。
典型使用场景：本地快速迭代 API 服务、CLI 工具调试、带 Web server 的小项目。
立即学习“go语言免费学习笔记（深入）”；
- 安装：
curl -sSfL https://raw.githubusercontent.com/cosmtrek/air/master/install.sh | sh -s -- -b $(go env GOPATH)/bin - 关键配置项（存为项目根目录
.air.toml）：[build] cmd = "go build -o ./tmp/main ." bin = "./tmp/main" delay = 1000 exclude_dir = ["tmp", "vendor", ".git"] exclude_file = [] include_ext = ["go", "mod", "sum", "env"] # ← 加上 mod/sum/env 才能响应依赖或环境变量变更 include_dir = [] full_bin = "" <p>[watch] exclude_dir = ["tmp", "vendor", ".git"] exclude_file = [] include_ext = ["go", "mod", "sum", "env"] include_dir = []
- 启动：
air（不是air start），它会自动找.air.toml
遇到 “address already in use” 别急着改端口
热编译时旧进程没杀干净，新进程启动失败并报 listen tcp :8080: bind: address already in use——这不是端口冲突问题，是 air 或你的程序没正确处理信号导致的残留。
根本原因：Go 程序未注册 os.Interrupt 或 syscall.SIGTERM 信号处理器，air 发送 SIGINT 后主 goroutine 退出，但 HTTP server 还在 ListenAndServe 阻塞中，无法优雅关闭。
- 修复方式：在
http.Server启动后加超时关闭逻辑，例如：srv := &http.Server{Addr: ":8080", Handler: r} go func() { if err := srv.ListenAndServe(); err != http.ErrServerClosed { log.Fatal(err) } }() // 收到中断信号时主动关服 quit := make(chan os.Signal, 1) signal.Notify(quit, os.Interrupt, syscall.SIGTERM) <-quit ctx, cancel := context.WithTimeout(context.Background(), 5*time.Second) defer cancel() srv.Shutdown(ctx) - 验证是否生效：Ctrl+C 一次，看日志里有没有
Server shutdown类提示；再启动air就不会卡住 - 如果仍失败，临时方案是加
killall -9 main（仅限 macOS/Linux），但说明程序信号处理有硬伤
Windows 下中文路径或空格会导致 air 启动失败
Windows 用户执行 air 报错 exec: "go": executable file not found in %PATH% 或直接闪退，大概率是项目路径含中文、空格，或 GOBIN 路径里有空格——air 的子进程调用逻辑在 Windows 上对空格转义不健壮。
这不是 Go 的问题，是 air 底层用 os/exec 启动命令时没加引号包裹路径。
- 绕过方法：把项目移到纯英文无空格路径，比如
C:\dev\myapp - 检查
go env GOPATH和GOBIN是否含空格，若有，用go env -w GOBIN=C:\gobin重设 - 替代方案：改用
reflex（Ruby 写的，对路径容错稍好），命令是reflex -r "\.go$" -- sh -c "go run main.go"，但需先装 Ruby
真正难搞的不是工具选型，而是信号处理没写对 + 路径没规整——这两点漏掉一个，热编译就永远差一口气。
