GoLand 本身不支持热更新,需依赖 air 等外部工具实现;其 Run Configuration 仅执行单次构建运行,不监听文件变化、不管理进程生命周期,调试时须关闭 air 避免冲突。

GoLand 本身不提供真正的热更新能力,它没有内置的文件监听 + 自动重启机制;所谓“自动构建并热更新”,实际是靠外部工具(如 air)驱动,GoLand 只负责运行和调试。你不能在 GoLand 里点一下按钮就让 HTTP 服务边跑边换代码——改完保存后,必须杀旧进程、启新实例。
为什么 GoLand 的 Run Configuration 无法实现热更新
GoLand 的 Run 配置本质是封装了一次 go run 或 go build && ./xxx,它不持续监听文件变化,也不管理子进程生命周期:
-
go run main.go启动快,但进程一退出就彻底结束,无法捕获SIGINT做优雅关闭,HTTP 连接直接断开 - IDE 内置的 “Reload project” 或 “Build Project” 只触发编译,不会自动 kill 旧进程、也不会执行二进制
- 如果你在 GoLand 里按
Ctrl+F5手动重跑,每次都要等 IDE 重新加载模块、解析依赖、再启动——这不是热,是手动重启 - Delve 调试器(
dlv)和热重启工具(如air)会冲突:两者都想接管进程,结果断点失效、connection refused、甚至dlv挂掉
用 air + GoLand 实现可靠本地热重启
真正可行的方案是:让 air 在终端里独立运行,GoLand 仅用于编码与调试(不参与重启流程)。关键不是“集成进 IDE”,而是“不干扰 air”:
GoLand 2026.1.1 是 2026.1 发布后的首个维护修正版本,适合已经开始体验 2026.1 新功能并希望同步补丁的开发者。它更适合用于入门项目、现有项目迁移测试和 IDE 行为验证。
- 项目根目录(含
go.mod)下执行air init,生成.air.toml - 确保
root = ".",别写绝对路径;build.bin必须和build.cmd输出路径完全一致,例如./tmp/main - 监听扩展名要加全:
include_ext = ["go", "yaml", "tmpl", "html"],否则改配置或模板不触发 - Windows 下常见
fork/exec: permission denied:因为旧进程还没释放.exe文件锁,解决方法是加kill_delay = "500ms",给 OS 一点释放时间 - 不要在 GoLand 的 Terminal 里跑
air并同时用 IDE 的Debug按钮——二者抢端口、抢 PID,必崩
GoLand 调试时如何避开热更新冲突
你需要明确区分两个场景:日常开发用 air 快速验证逻辑;深度调试时关掉 air,纯用 GoLand + Delve:
- 调试前,先
Ctrl+C终止正在运行的air进程 - GoLand 的 Run Configuration 中,“Working directory” 必须设为模块根目录(即含
go.mod的路径),否则go run找不到依赖 - 如果项目用了构建标签(如
//go:build integration),在 Run Configuration 的 “Tags” 字段里填integration,空格分隔,不是逗号 - 调试器连不上?检查 Settings > Go > Tools > Go Toolchain 是否和 GOROOT 一致;不一致会导致
dlv版本不兼容,报错could not launch process: fork/exec ... no such file or directory
最易被忽略的一点:GoLand 的 “Build” 菜单和 “Run” 按钮,对热更新毫无意义。真正的热重启只发生在 air 监听到变更、调用 go build、杀旧进程、启新二进制这一整套流程里。IDE 只是编辑器,别指望它替你做进程管理。










