air是goland中最轻量可靠的热重载方案，无需修改项目结构或侵入业务逻辑，只需终端支持go build即可运行；其核心优势在于通过terminal直接启动，规避ide运行配置的路径、环境变量等干扰。
air 是目前 GoLand 里最轻量、最可靠的热重载方案，不需要改项目结构、不侵入业务逻辑，只要终端能跑 go build，它就能工作。
为什么直接在 GoLand 终端运行 air 最简单
GoLand 底部的 Terminal 标签页本质就是个 shell，和你手动开 cmd/PowerShell/Terminal 完全一致。用它启动 air，等于把热重载完全交给进程本身管理，避开了 IDE 运行配置的路径、环境变量、工作目录等隐性干扰。
常见错误现象：在 GoLand 的 “Run Configuration” 里配了个 air 启动项，但保存文件没反应——大概率是 Working directory 没对上，或 IDE 把 air 当成普通命令执行后就结束了，没保持长连接。
- 打开 GoLand → 底部点
Terminal - 确认当前路径是项目根目录（含
go.mod），不是子包或configs/这类子目录 - 运行
air（确保已全局安装：go install github.com/cosmtrek/air@latest） - 修改任意
.go文件并Ctrl+S，终端出现building...即生效
停止只需 Ctrl+C，不会影响 GoLand 其他功能。
viper.WatchConfig() 不触发？先盯死配置路径
热重载代码配置（比如 config.yaml）和热重载服务进程是两回事。air 负责重启进程，viper.WatchConfig() 负责监听文件变更——但它的监听行为极度依赖你传进去的路径是否精确。
典型错误：你写了 viper.AddConfigPath("./configs") + viper.SetConfigName("app")，然后调 viper.WatchConfig()，结果改了 ./configs/app.yaml 没反应。
GoLand 2026.1.1 是 2026.1 发布后的首个维护修正版本，适合已经开始体验 2026.1 新功能并希望同步补丁的开发者。它更适合用于入门项目、现有项目迁移测试和 IDE 行为验证。
-
viper.WatchConfig()默认监听的是viper.ConfigFileUsed()返回的路径，不是AddConfigPath的目录 - 必须显式指定完整路径：
viper.SetConfigFile("./configs/app.yaml")，再调viper.WatchConfig() - 在 GoLand 的 Run Configuration 里检查
Working directory，确保它和SetConfigFile中的相对路径能对上（比如设为$ProjectFileDir$） - 加一行日志验证是否收到事件：
viper.OnConfigChange(func(e fsnotify.Event) { log.Printf("watch event: %+v", e) })
如果日志没输出，说明根本没监听到文件变化——路径错、权限问题、或文件系统不支持 inotify（如某些 Docker 挂载场景）。
viper.WatchConfig() 回调里只打印日志不算热加载
viper.WatchConfig() 只发通知，不自动刷新数据。很多同学加了回调、看到日志，就以为配置已更新，结果 viper.GetInt("port") 还是旧值，结构体字段也纹丝不动。
- 回调第一行必须是
viper.ReadInConfig()：否则内部缓存不更新，所有viper.Get*方法仍返回旧内容 - 紧接着必须是
viper.Unmarshal(&cfg)：否则你的 Go 结构体cfg字段不会变，哪怕viper.Get已正确 - 结构体字段要预先初始化，尤其是
map、slice、指针字段，否则Unmarshal可能 panic - 别手动赋值：
cfg.Port = viper.GetInt("port")—— 这会绕过mapstructuretag、默认值、嵌套结构解析
漏掉任意一步，热加载就只是“看起来在动”，实际业务读到的还是冷启动时的那批配置。
重构 ≠ 热重载，air 不处理变量重命名
保存即编译运行，不等于保存即重构。当你改函数名、移动方法、调整 struct 字段时，air 只负责杀进程 → go build → 启新进程，它不解析 AST、不调 gopls 的 rename API、也不做任何语义检查。
所以：改完 func DoSomething() 为 func DoWork()，air 会编译失败（因为调用处还没改），但它不会帮你把所有调用点一起改掉——那是 IDE 的 Refactor → Rename 干的事。
真正需要“保存即重构”的场景，得靠 GoLand 自身的实时分析能力，而不是热重载工具。把 air 当作快速验证运行态逻辑的开关，别指望它替代 IDE 的语言服务。
