GoLand配Air热重载核心三步：正确安装air-verse/air、将%USERPROFILE%\go\bin（Win）或$(go env GOPATH)/bin（macOS/Linux）加入PATH并重启GoLand、在项目根目录终端直接运行air；90%失败源于安装源错误或PATH未生效。
GoLand 里配 Air 热重载，核心就三件事：装对、路径通、命令跑得起来。其他配置都是锦上添花，90% 的失败卡在前两步。
air 命令找不到？先查 PATH 和安装源
GoLand 内置终端默认不继承系统环境变量（尤其是 Windows 用户级 PATH），所以即使你用 go install github.com/air-verse/air@latest 装好了，air -v 仍可能报 “不是内部或外部命令”。
- Windows：确认
%USERPROFILE%\go\bin已加进用户级 PATH，并且 GoLand 是**重启后**打开的（旧窗口不读新 PATH） - macOS/Linux：检查
$(go env GOPATH)/bin是否在 shell 配置里（如~/.zshrc），然后在 GoLand Terminal 里执行source ~/.zshrc或直接新开终端 - 别再用旧仓库地址
github.com/cosmtrek/air—— 官方已迁移到github.com/air-verse/air，旧地址会因 module path 冲突导致安装静默失败
air 启动就报 failed to build？先跑 go build 定位真问题
Air 启动失败时，终端最后一行红字才是关键线索，比如 undefined: xxx 或 import cycle not allowed。Air 本身不编译代码，它只是调 go build；所谓“热重载失败”，90% 是代码根本编译不过。
- 在项目根目录（含
go.mod）手动执行go build -o ./tmp/main .，看是否报错 - 如果
go build失败，Air 必然失败 —— 别急着改.air.toml，先修 Go 代码 -
cannot find module providing package？说明当前目录没go.mod，或者你在子目录（如cmd/api）下误启了 Air
改 config.yaml 或 template.html 不触发重启？两个地方都要加后缀
Air 默认只监听 .go 文件，其他类型必须显式声明，而且要同时出现在 [watch] 和 [build] 两个 section —— 少一个，文件变了也不 rebuild。
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
立即学习“go语言免费学习笔记（深入）”；
- 在
.air.toml里补全这两段（示例含常见配置文件）：
[watch] include_ext = ["go", "yaml", "yml", "html", "tmpl", "json"] [build] include_ext = ["go", "yaml", "yml", "html", "tmpl", "json"]
- 别乱加后缀，Linux/macOS 上监听太多文件可能耗尽 inotify 句柄（默认 8192），大项目建议只列真正需要 reload 的扩展名
- Windows 用户注意：某些杀毒软件（如火绒、360）会拦截 Air 创建临时二进制或写
tmp/目录，可临时关闭实时防护测试
GoLand 里怎么启动最稳？别用 Run Configuration
GoLand 的 “Edit Configurations” 里加 Air 启动项看似方便，但容易因工作目录、环境变量、Shell 类型（PowerShell vs cmd）不一致导致失败。最简方案就是用内置 Terminal。
- 确保当前 Terminal 工作目录是项目根（有
main.go和go.mod） - 直接输入
air回车 —— 它会自动找入口、建tmp/main、监听、重启 - 停止用
Ctrl+C，Air 会自动清理tmp/目录；不要用后台运行（nohup），否则进程残留易占端口 - 如果要用 Run Configuration，务必勾选 “Add content root to classpath” 和 “Include system environment variables”，并手动设 Working directory 为项目根路径
真正容易被忽略的是：Air 的 reload 是进程级重启，不是运行时替换。改完 config.yaml 后服务没立刻生效？那不是 Air 的事，得你自己用 viper.WatchConfig() + 回调里调 viper.ReadInConfig() 才行 —— 热重载和配置热加载，从来就不是一回事。
